Применимо к: Exchange Server 2010 SP1
Последнее изменение раздела: 2011-03-19
Используйте командлет Remove-ManagementRole для удаления настраиваемых ролей управления, которые больше не требуются.
Синтаксис
Remove-ManagementRole -Identity <RoleIdParameter>
[-Confirm [<SwitchParameter>]] [-DomainController
<Fqdn>] [-Force <SwitchParameter>] [-Recurse
<SwitchParameter>] [-UnScopedTopLevel
<SwitchParameter>] [-WhatIf [<SwitchParameter>]]
|
Параметры
| Параметр | Обязательный | Тип | Описание | ||
|---|---|---|---|---|---|
|
Identity |
Обязательный |
Microsoft.Exchange.Configuration.Tasks.RoleIdParameter |
Параметр Identity указывает удаляемую настраиваемую роль. Если имя содержит роли пробелы, его необходимо заключить в кавычки ("). |
||
|
Confirm |
Необязательный |
System.Management.Automation.SwitchParameter |
|||
|
DomainController |
Необязательный |
Microsoft.Exchange.Data.Fqdn |
|||
|
Force |
Необязательный |
System.Management.Automation.SwitchParameter |
|||
|
Recurse |
Необязательный |
System.Management.Automation.SwitchParameter |
Параметр Recurse удаляет все дочерние роли, определенные с помощью параметра Identity, и затем удаляет указанную роль.
|
||
|
UnScopedTopLevel |
Необязательный |
System.Management.Automation.SwitchParameter |
Переключатель UnScopedTopLevel указывает, что роль, которую пользователь пытается удалить, является ролью высокого уровня с незаданной областью. Необходимо использовать этот переключатель, если нужно удалить роль высокого уровня с незаданной областью. |
||
|
WhatIf |
Необязательный |
System.Management.Automation.SwitchParameter |
Внимание!Подробное описание
Необходимо удалить все назначения роли управления из роли перед ее удалением. Если роль является родителем, перед ее удалением необходимо удалить дочерние роли или использовать параметр Recurse. Можно удалить только настраиваемые роли. Встроенные роли, такие как роль получателей почты, удалить нельзя. Дополнительные сведения о порядке удаления настраиваемой роли см. в разделе Удаление роли.
Подраздел «Роли управления» в разделе Разрешения управления ролями.
Типы входных данных
Типы возвращаемых данных
Ошибки
| Ошибка | Описание |
|---|---|
|
|
|
Примеры
ПРИМЕР 1
В этом примере удаляется одна роль ExampleRole1.
 Скопировать код |
|
|---|---|
Remove-ManagementRole ExampleRole1 |
|
ПРИМЕР 2
В этом примере выполняется командлет Remove-ManagementRole с переключателем WhatIf. Переключатель WhatIf позволяет команде выполнять указанные действия без внесения каких-либо изменений. Вместо этого отображаются потенциальные результаты, чтобы можно было проверить правильность действий.
| Скопировать код |
|
|---|---|
Remove-ManagementRole ExampleRole2 -Recurse -WhatIf |
|
Если отображаются запланированные результаты, можно
использовать следующую команду, чтобы удалить родительскую роль
ExampleRole2 и все дочерние роли.
| Скопировать код |
|
|---|---|
Remove-ManagementRole ExampleRole2 -Recurse |
|
ПРИМЕР 3
В этом примере используется командлет Get-ManagementRole, чтобы вернуть список ролей, содержащий строку в имени роли, который затем передается в командлет Remove-ManagementRole. Так как указан переключатель WhatIf, командлет Remove-ManagementRole отображает роли, которые должны быть удалены, но не выполняет каких-либо изменений. Если отображаются запланированные результаты, команду можно выполнить снова без переключателя WhatIf, чтобы удалить роли.
| Скопировать код |
|
|---|---|
Get-ManagementRole *Example* | Remove-ManagementRole -WhatIf |
|
ПРИМЕР 4
В этом примере удаляется роль высокого уровня с незаданной областью «In-house scripts». Так как это роль высокого уровня с незаданной областью, необходимо использовать переключатель UnScopedTopLevel.
| Скопировать код |
|
|---|---|
Remove-ManagementRole "In-house scripts" -UnScopedTopLevel |
|
Дополнительные сведения о ролях управления верхнего уровня, не имеющих областей, см. в разделе Общие сведения о ролях управления.