Remove-CMObjectSecurityScope

  • Referência
Módulo:
ConfigurationManager

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

Syntax

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.

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

-DisableWildcardHandling

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

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

-Force

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 .

Type:String
Aliases:SecurityScopeId
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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.

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

-Name

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

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

-Scope

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

Type:IResultObject[]
Aliases:SecurityScope, SecuredCategory, Scopes, SecurityScopes, SecuredCategories
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

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

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

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject[]

Saídas

System.Object