Share via

Remove-CMSecurityRole

  • Referência
Módulo:
ConfigurationManager

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

Syntax

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.

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 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.)

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

-InputObject

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

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

-Name

Especifique o nome da função de segurança a ser removida.

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

-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