Compartilhar via

Remove-CMSecurityRole

  • Referência
Módulo:
ConfigurationManager

Remova uma função de segurança personalizada.

Sintaxe

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

Description

Use esse cmdlet para remover uma função de segurança personalizada de Configuration Manager. Especifique o nome ou a ID de uma função de segurança que você deseja remover ou usar o cmdlet Get-CMSecurityRole para obter uma.

Você pode usar o cmdlet Remove-CMSecurityRole para remover funções de segurança personalizadas antigas e desnecessárias. Você não pode remover funções de segurança internas. Cada usuário administrativo deve ter pelo menos uma função de segurança. Antes de remover uma função de segurança, verifique se cada usuário tem uma função além da que você remove.

Para obter mais informações sobre funções de segurança e permissões, 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 uma função de segurança usando um nome

Esse comando remove uma função de segurança chamada MainSecurityRole. O comando usa o parâmetro Force para que ele não solicite a confirmação.

Remove-CMSecurityRole -Name "MainSecurityRole" -Force

Exemplo 2: remover uma função de segurança usando uma variável

O primeiro comando usa o cmdlet Get-CMSecurityRole para obter todas as funções de segurança que começam com Custome as armazena na variável $role .

O segundo comando remove a primeira função de segurança armazenada na matriz. Como ele não especifica o parâmetro Force , esse comando solicita a confirmação.

$role = Get-CMSecurityRole -Name "Custom*"
Remove-CMSecurityRole -InputObject $role[1]

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 da função de segurança a ser removida. Esse valor é a RoleID propriedade. Como esse cmdlet só funciona com funções personalizadas, esse valor deve sempre começar com o código do site. (As IDs para funções internas começam com SMS.)

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

-InputObject

Especifique um objeto de função de segurança a ser removido. Para obter esse objeto, use o cmdlet Get-CMSecurityRole .

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 da função de segurança a ser removida.

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

-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