Compartilhar via

Remove-CMObjectSecurityScope

  • Referência
Módulo:
ConfigurationManager

Remova um escopo de segurança de um objeto Configuration Manager.

Sintaxe

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>]

Description

Use esse cmdlet para remover um ou mais escopos de segurança de um objeto Configuration Manager.

Para obter mais informações sobre escopos de segurança, consulte Fundamentos da administração baseada em função em Configuration Manager.

Observação

Execute Configuration Manager cmdlets da unidade do site Configuration Manager, por exemplo PS XYZ:\>. Para obter mais informações, confira introdução.

Exemplos

Exemplo 1: remover um escopo de segurança de um aplicativo

O primeiro comando obtém o escopo de segurança chamado Scope1 e armazena o objeto na variável $Scope .

O segundo comando obtém todos os objetos de aplicativo cujo nome começa com "Central". Em seguida, ele usa o operador de pipeline para passar os objetos para Remove-CMObjectSecurityScope.

O último comando remove o escopo de segurança de cada um dos objetos do aplicativo. O parâmetro Force indica que você não foi solicitado antes da execução do cmdlet.

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

Exemplo 3: adicionar um novo escopo de segurança e remover todas as outras do objeto de aplicativo

O primeiro comando obtém um escopo de segurança na variável TeamABCScope. O segundo comando obtém um objeto de aplicativo para Edge Enterprise Stable. O terceiro comando adiciona o novo TeamABCScope ao aplicativo. O último comando obtém escopos do aplicativo que não são TeamABCScope e remove todos eles.

$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
  }

Parâmetros

-Confirm

Solicita a confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DisableWildcardHandling

Esse parâmetro trata caracteres curinga como valores de caractere literal. Você não pode combiná-lo com ForceWildcardHandling.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Force

Força o comando a ser executado sem pedir a confirmação do usuário.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ForceWildcardHandling

Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Você não pode combiná-lo com DisableWildcardHandling.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Id

Especifique a ID de um escopo de segurança associado a um objeto Configuration Manager. Esse valor é a CategoryID propriedade, por exemplo SMS00UNA , para o escopo Padrão .

Tipo:String
Aliases:SecurityScopeId
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-InputObject

Especifique uma matriz de objetos Configuration Manager associados a um escopo de segurança. Para obter esse objeto, use o cmdlet Get para o tipo de objeto. Por exemplo, Get-CMApplication para objetos de aplicativo.

Tipo:IResultObject[]
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Name

Especifique o nome de um escopo de segurança associado a um objeto Configuration Manager.

Tipo:String
Aliases:SecurityScopeName
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Scope

Especifique uma matriz de objetos de escopo de segurança a serem removidos. Para obter esse objeto, use o cmdlet Get-CMSecurityScope .

Tipo:IResultObject[]
Aliases:SecurityScope, SecuredCategory, Scopes, SecurityScopes, SecuredCategories
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WhatIf

Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject[]

Saídas

System.Object