Skip to content

Commit babe4ec

Browse files
authored
Update New-ManagementRole.md
Added on-prem only and Unscoped Role Management role only to UnScopedTopLevel parameter per Issue #1387
1 parent 61810a8 commit babe4ec

File tree

1 file changed

+12
-4
lines changed

1 file changed

+12
-4
lines changed

exchange/exchange-ps/exchange/role-based-access-control/New-ManagementRole.md

Lines changed: 12 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -67,7 +67,7 @@ For more information about pipelining and the Where cmdlet, see the following to
6767
New-ManagementRole -Name "In-house scripts" -UnScopedTopLevel
6868
```
6969

70-
This example creates the unscoped management role In-house scripts. The user running the command, or the role group the user is a member of, is assigned the Unscoped Role Management management role. This assignment is required to use the UnScopedTopLevel switch.
70+
In on-premises Exchange, this example creates the unscoped management role In-house scripts. Note that the UnScopedTopLevel switch requires the Unscoped Role Management role, which isn't assigned to any role group by default.
7171

7272
## PARAMETERS
7373

@@ -102,13 +102,19 @@ Accept wildcard characters: False
102102
```
103103
104104
### -UnScopedTopLevel
105-
The UnScopedTopLevel switch specifies that the role should be a custom, empty role. If you specify the UnScopedTopLevel switch, you can't use the Parent parameter.
105+
This parameter is available on in on-premises Exchange.
106+
107+
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).
108+
109+
The UnScopedTopLevel switch specifies that the role should be a custom, empty role. You don't need to specify a value with this switch.
110+
111+
If you use this switch, you can't use the Parent parameter.
106112
107113
```yaml
108114
Type: SwitchParameter
109115
Parameter Sets: Set2
110116
Aliases:
111-
Applicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Online, Exchange Online Protection
117+
Applicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016
112118
Required: True
113119
Position: Named
114120
Default value: None
@@ -168,13 +174,15 @@ Accept wildcard characters: False
168174
```
169175
170176
### -Force
177+
This parameter is available only in the cloud-based service.
178+
171179
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.
172180
173181
```yaml
174182
Type: SwitchParameter
175183
Parameter Sets: (All)
176184
Aliases:
177-
Applicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Online, Exchange Online Protection
185+
Applicable: Exchange Online, Exchange Online Protection
178186
Required: False
179187
Position: Named
180188
Default value: None

0 commit comments

Comments
 (0)