Skip to content

Commit 643d905

Browse files
committed
Updates to UnScopedTopLevel parameter
Per Issue #1741.
1 parent f68d028 commit 643d905

File tree

5 files changed

+17
-7
lines changed

5 files changed

+17
-7
lines changed

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

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -223,9 +223,11 @@ This parameter is available on in on-premises Exchange.
223223
224224
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).
225225
226-
The UnScopedTopLevel switch specifies that you're adding a custom script or non-Exchange cmdlet to an unscoped top-level management role. You don't need to specify a value with this switch.
226+
The UnScopedTopLevel switch specifies that you're adding the role entry to an unscoped top-level management role. You don't need to specify a value with this switch.
227227
228-
You can only use this switch when you add a role entry to an unscoped top-level role. When you use this switch, you can't use the ParentRoleEntry parameter.
228+
Unscoped top-level management roles can only contain custom scripts or non-Exchange cmdlets. For more information, see Create an unscoped role(https://technet.microsoft.com/library/dd876886.aspx).
229+
230+
You can't use this switch with the ParentRoleEntry parameter.
229231
230232
```yaml
231233
Type: SwitchParameter

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

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -106,9 +106,11 @@ This parameter is available on in on-premises Exchange.
106106
107107
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).
108108
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.
109+
The UnScopedTopLevel switch specifies that the role new role is an unscoped top-level management role (a custom, empty role). You don't need to specify a value with this switch.
110110
111-
If you use this switch, you can't use the Parent parameter.
111+
You can only add custom scripts or non-Exchange cmdlets to an unscoped top-level management role. For more information, see Create an unscoped role(https://technet.microsoft.com/library/dd876886.aspx).
112+
113+
You can't use this switch with the Parent parameter.
112114
113115
```yaml
114116
Type: SwitchParameter

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

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -404,7 +404,9 @@ This parameter is available on in on-premises Exchange.
404404
405405
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).
406406
407-
The UnScopedTopLevel switch specifies that the role provided with the Role parameter is an unscoped top level management role. You don't need to specify a value with this switch.
407+
The UnScopedTopLevel switch specifies that the role provided with the Role parameter is an unscoped top-level management role. You don't need to specify a value with this switch.
408+
409+
Unscoped top-level management roles can only contain custom scripts or non-Exchange cmdlets. For more information, see Create an unscoped role(https://technet.microsoft.com/library/dd876886.aspx).
408410
409411
```yaml
410412
Type: SwitchParameter

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

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -153,7 +153,9 @@ This parameter is available on in on-premises Exchange.
153153
154154
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).
155155
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.
156+
The UnScopedTopLevel switch specifies the role that you want to remove is an unscoped top-level role. You don't need to specify a value with this switch.
157+
158+
Unscoped top-level management roles can only contain custom scripts or non-Exchange cmdlets.
157159
158160
You must use this switch if you want to remove an unscoped top-level role.
159161

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

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -177,7 +177,9 @@ This parameter is available on in on-premises Exchange.
177177
178178
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).
179179
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.
180+
The UnScopedTopLevel switch specifies the role entry that you want to modify is on an unscoped top-level role. You don't need to specify a value with this switch.
181+
182+
Unscoped top-level management roles can only contain custom scripts or non-Exchange cmdlets. For more information, see Create an unscoped role(https://technet.microsoft.com/library/dd876886.aspx).
181183
182184
You must use this switch to modify role entries on unscoped top level roles.
183185

0 commit comments

Comments
 (0)