Remove-CMSecurityRole

  • Ссылка
Модуль:
ConfigurationManager

Удаление настраиваемой роли безопасности.

Синтаксис

Remove-CMSecurityRole
      [-Force]
      -InputObject <IResultObject>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMSecurityRole
      [-Force]
      -Id <String>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMSecurityRole
      [-Force]
      -Name <String>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Описание

Используйте этот командлет, чтобы удалить пользовательскую роль безопасности из Configuration Manager. Укажите имя или идентификатор роли безопасности, которую требуется удалить, или используйте командлет Get-CMSecurityRole для ее получения.

Командлет Remove-CMSecurityRole можно использовать для удаления старых ненужных пользовательских ролей безопасности. Вы не можете удалить встроенные роли безопасности. Каждый пользователь с правами администратора должен иметь по крайней мере одну роль безопасности. Перед удалением роли безопасности убедитесь, что у каждого пользователя есть роль в дополнение к удаляемой.

Дополнительные сведения о ролях безопасности и разрешениях см. в статье Основы ролевого администрирования в Configuration Manager.

Примечание.

Выполните командлеты Configuration Manager с диска сайта Configuration Manager, например PS XYZ:\>. Дополнительные сведения см. в статье Начало работы.

Примеры

Пример 1. Удаление роли безопасности с помощью имени

Эта команда удаляет роль безопасности с именем MainSecurityRole. Команда использует параметр Force , поэтому не запрашивает подтверждение.

Remove-CMSecurityRole -Name "MainSecurityRole" -Force

Пример 2. Удаление роли безопасности с помощью переменной

Первая команда использует командлет Get-CMSecurityRole для получения всех ролей безопасности, которые начинаются с Custom, и сохраняет их в переменной $role .

Вторая команда удаляет первую роль безопасности, хранящуюся в массиве. Так как параметр Force не указан, эта команда запрашивает подтверждение.

$role = Get-CMSecurityRole -Name "Custom*"
Remove-CMSecurityRole -InputObject $role[1]

Параметры

-Confirm

Перед запуском командлет запросит подтверждение.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisableWildcardHandling

Этот параметр обрабатывает подстановочные знаки как литеральные символы. Вы не можете объединить его с ForceWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

Принудительно выполняет команду без запроса подтверждения пользователя.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ForceWildcardHandling

Этот параметр обрабатывает подстановочные знаки и может привести к непредвиденному поведению (не рекомендуется). Его нельзя объединить с DisableWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Id

Укажите идентификатор удаляемой роли безопасности. Это значение является свойством RoleID . Так как этот командлет работает только с пользовательскими ролями, это значение всегда должно начинаться с кода сайта. (Идентификаторы встроенных ролей начинаются с SMS.)

Type:String
Aliases:RoleId
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Укажите удаляемый объект роли безопасности. Чтобы получить этот объект, используйте командлет Get-CMSecurityRole .

Type:IResultObject
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

Укажите имя удаляемой роли безопасности.

Type:String
Aliases:RoleName
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:True

-WhatIf

Показывает, что произойдет при запуске этого командлета. Командлет не выполняется.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Входные данные

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Выходные данные

System.Object