Remove-CMObjectSecurityScope

  • Referência
Módulo:
ConfigurationManager

Remova um âmbito de segurança de um objeto do 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

Utilize este cmdlet para remover um ou mais âmbitos de segurança de um objeto do Configuration Manager.

Para obter mais informações sobre âmbitos de segurança, veja Noções básicas da administração baseada em funções no Configuration Manager.

Observação

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

Exemplos

Exemplo 1: Remover um âmbito de segurança de uma aplicação

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

O segundo comando obtém todos os objetos da aplicação cujo nome começa por "Central". Em seguida, utiliza o operador de pipeline para transmitir os objetos para Remove-CMObjectSecurityScope.

O último comando remove o âmbito de segurança de cada um dos objetos da aplicação. O parâmetro Force indica que não lhe é pedido antes de o cmdlet ser executado.

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

Exemplo 3: adicionar um novo âmbito de segurança e, em seguida, remover todas as outras pessoas do objeto da aplicação

O primeiro comando obtém um âmbito de segurança na variável TeamABCScope. O segundo comando obtém um objeto de aplicação para o Edge Enterprise Stable. O terceiro comando adiciona o novo TeamABCScope à aplicação. O último comando obtém âmbitos da aplicação que não são TeamABCScope e, em seguida, remove-os a todos.

$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

Este parâmetro trata os carateres universais como valores de carateres literais. 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 utilizador.

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

-ForceWildcardHandling

Este parâmetro processa carateres universais e pode levar a um comportamento inesperado (não recomendado). 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 o ID de um âmbito de segurança associado a um objeto do Configuration Manager. Este valor é a CategoryID propriedade , por exemplo SMS00UNA , para o Âmbito predefinido .

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 do Configuration Manager que estão associados a um âmbito de segurança. Para obter este objeto, utilize o cmdlet Get para o tipo de objeto. Por exemplo, Get-CMApplication para objetos de aplicação.

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 âmbito de segurança associado a um objeto do 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 âmbito de segurança a remover. Para obter este objeto, utilize 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