Skip to content

Commit 410fa36

Browse files
authored
Update Set-ManagementRoleEntry.md
Added on-prem only and Unscoped Role Management role only to UnScopedTopLevel parameter per Issue #1387
1 parent bd3e84a commit 410fa36

File tree

1 file changed

+14
-6
lines changed

1 file changed

+14
-6
lines changed

exchange/exchange-ps/exchange/role-based-access-control/Set-ManagementRoleEntry.md

Lines changed: 14 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -34,7 +34,7 @@ You need to be assigned permissions before you can run this cmdlet. Although thi
3434

3535
### -------------------------- Example 1 --------------------------
3636
```
37-
Set-ManagementRoleEntry "Help Desk Personnel\Get-Mailbox" -Parameters Anr, Database -RemoveParameter
37+
Set-ManagementRoleEntry "Help Desk Personnel\Get-Mailbox" -Parameters "Anr","Database" -RemoveParameter
3838
```
3939

4040
This example removes the Anr and Database parameters from the Get-Mailbox role entry on the Help Desk Personnel role.
@@ -48,7 +48,7 @@ This example retrieves a list of role entries on the Help Desk Personnel role an
4848

4949
### -------------------------- Example 3 --------------------------
5050
```
51-
Set-ManagementRoleEntry "Tier 1 Help Desk\Set-Mailbox" -Parameters DisplayName, ForwardingAddress
51+
Set-ManagementRoleEntry "Tier 1 Help Desk\Set-Mailbox" -Parameters "DisplayName","ForwardingAddress"
5252
```
5353

5454
This example adds the DisplayName and ForwardingAddress parameters to the Set-Mailbox role entry on the Tier 1 Help Desk role and removes all other parameters from the role entry.
@@ -58,7 +58,7 @@ This example adds the DisplayName and ForwardingAddress parameters to the Set-Ma
5858
Set-ManagementRoleEntry "IT Scripts\MailboxAudit" -Parameters Location -AddParameter -UnScopedTopLevel
5959
```
6060

61-
This example adds the Location parameter to the MailboxAudit custom script on the IT Scripts unscoped top level role.
61+
In on-premises Exchange, this example adds the Location parameter to the MailboxAudit custom script on the IT Scripts unscoped top level role. Note that the UnScopedTopLevel switch requires the UnScoped Role Management role, which isn't assigned to any role groups by default.
6262

6363
## PARAMETERS
6464

@@ -173,13 +173,19 @@ Accept wildcard characters: False
173173
```
174174
175175
### -UnScopedTopLevel
176-
The UnScopedTopLevel switch must be used when you want to modify a role entry on an unscoped top level role.
176+
This parameter is available on in on-premises Exchange.
177+
178+
By default, this parameter is only available in the UnScoped Role Management role, and that role isn't assigned to any role groups. To use this parameter, you need to add the UnScoped Role Management role to a role group (for example, to the Organization Management role group). For more information, see the "Add a role to a role group" section in Manage role groups (https://technet.microsoft.com/library/jj657480.aspx).
179+
180+
The UnScopedTopLevel switch specifies the role entry is on an unscoped top level role. You don't need to specify a value with this switch.
181+
182+
You must use this switch to modify role entries on unscoped top level roles.
177183
178184
```yaml
179185
Type: SwitchParameter
180186
Parameter Sets: (All)
181187
Aliases:
182-
Applicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Online, Exchange Online Protection
188+
Applicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016
183189
Required: False
184190
Position: Named
185191
Default value: None
@@ -203,13 +209,15 @@ Accept wildcard characters: False
203209
```
204210
205211
### -Force
212+
This parameter is available only in the cloud-based service.
213+
206214
The Force switch specifies whether to suppress warning or confirmation messages. You can use this switch to run tasks programmatically where prompting for administrative input is inappropriate. You don't need to specify a value with this switch.
207215
208216
```yaml
209217
Type: SwitchParameter
210218
Parameter Sets: (All)
211219
Aliases:
212-
Applicable: Exchange Server 2013, Exchange Server 2016, Exchange Online, Exchange Online Protection
220+
Applicable: Exchange Online, Exchange Online Protection
213221
Required: False
214222
Position: Named
215223
Default value: None

0 commit comments

Comments
 (0)