Skip to content

Commit bd3e84a

Browse files
authored
Update Remove-ManagementRole.md
Added on-prem only and Unscoped Role Management role only to UnScopedTopLevel parameter per Issue #1387
1 parent e119196 commit bd3e84a

File tree

1 file changed

+12
-4
lines changed

1 file changed

+12
-4
lines changed

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

Lines changed: 12 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -57,7 +57,7 @@ This example uses the Get-ManagementRole cmdlet to get a list of roles that cont
5757
Remove-ManagementRole "In-house scripts" -UnScopedTopLevel
5858
```
5959

60-
This example removes the In-house scripts unscoped top-level management role. Because this is an unscoped top-level role, the UnScopedTopLevel switch must be used.
60+
In on-premises Exchange, this example removes the In-house scripts unscoped top-level management role. Because this is an unscoped top-level role, the UnScopedTopLevel switch must be used. Note that the UnScopedTopLevel switch requires the UnScoped Role Management role, which isn't assigned to any role groups by default.
6161

6262
For more information about unscoped top-level management roles, see Understanding management roles (https://technet.microsoft.com/library/dd298116.aspx).
6363

@@ -115,13 +115,15 @@ Accept wildcard characters: False
115115
```
116116
117117
### -Force
118+
This parameter is available only in the cloud-based service.
119+
118120
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.
119121
120122
```yaml
121123
Type: SwitchParameter
122124
Parameter Sets: (All)
123125
Aliases:
124-
Applicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Online, Exchange Online Protection
126+
Applicable: Exchange Online, Exchange Online Protection
125127
Required: False
126128
Position: Named
127129
Default value: None
@@ -147,13 +149,19 @@ Accept wildcard characters: False
147149
```
148150
149151
### -UnScopedTopLevel
150-
The UnScopedTopLevel switch specifies that the role you're trying to remove is an unscoped top-level role. You must use this switch if you want to remove an unscoped top-level role.
152+
This parameter is available on in on-premises Exchange.
153+
154+
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).
155+
156+
The UnScopedTopLevel switch specifies that the role you're trying to remove is an unscoped top-level role. You don't need to specify a value with this switch.
157+
158+
You must use this switch if you want to remove an unscoped top-level role.
151159
152160
```yaml
153161
Type: SwitchParameter
154162
Parameter Sets: (All)
155163
Aliases:
156-
Applicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Online, Exchange Online Protection
164+
Applicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016
157165
Required: False
158166
Position: Named
159167
Default value: None

0 commit comments

Comments
 (0)