Remove-CMObjectSecurityScope

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

Удалите область безопасности из объекта Configuration Manager.

Синтаксис

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

Описание

Используйте этот командлет для удаления одной или нескольких областей безопасности из объекта Configuration Manager.

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

Примечание.

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

Примеры

Пример 1. Удаление области безопасности из приложения

Первая команда получает область безопасности с именем Scope1 и сохраняет объект в переменной $Scope .

Вторая команда получает все объекты приложения, имя которых начинается с "Central". Затем он использует оператор конвейера для передачи объектов в Remove-CMObjectSecurityScope.

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

$Scope = Get-CMSecurityScope -Name "Scope1"
$apps = Get-CMApplication -Name "Central*"
$app | Remove-CMObjectSecurityScope -Scope $Scope -Force

Пример 3. Добавление новой области безопасности, а затем удаление всех остальных из объекта приложения

Первая команда получает область безопасности в переменной TeamABCScope. Вторая команда получает объект приложения для Edge Enterprise Stable. Третья команда добавляет в приложение новый TeamABCScope . Последняя команда получает из приложения области, которые не являются TeamABCScope, а затем удаляет их все.

$ScopeName = "Team ABC"
$TeamABCScope = Get-CMSecurityScope | Where-Object {$_.CategoryName -eq $ScopeName}

$app = Get-CMApplication -Name "Edge Enterprise Stable"

Add-CMObjectSecurityScope -InputObject $app -Scope $TeamABCScope

$scopes = Get-CMObjectSecurityScope -InputObject $app | Where-Object {$_.CategoryName -ne $ScopeName}
foreach ( $ExtraScope in $scopes )
  {
  Remove-CMObjectSecurityScope -InputObject $app -Scope $ExtraScope -Force
  }

Параметры

-Confirm

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

Тип:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-DisableWildcardHandling

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

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Force

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

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-ForceWildcardHandling

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

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Id

Укажите идентификатор области безопасности, связанной с объектом Configuration Manager. Это значение является свойством CategoryID , например SMS00UNA для области по умолчанию .

Тип:String
Aliases:SecurityScopeId
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-InputObject

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

Тип:IResultObject[]
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-Name

Укажите имя области безопасности, связанной с объектом Configuration Manager.

Тип:String
Aliases:SecurityScopeName
Position:0
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Scope

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

Тип:IResultObject[]
Aliases:SecurityScope, SecuredCategory, Scopes, SecurityScopes, SecuredCategories
Position:0
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-WhatIf

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

Тип:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

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

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject[]

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

System.Object