Remove-CMObjectSecurityScope
Удалите область безопасности из объекта 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