Remove-CMSecurityRole

  • Referência
Módulo:
ConfigurationManager

Remover 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

Utilize este cmdlet para remover uma função de segurança personalizada do Configuration Manager. Especifique o nome ou ID de uma função de segurança que pretende remover ou utilize o cmdlet Get-CMSecurityRole para obter uma.

Pode utilizar o cmdlet Remove-CMSecurityRole para remover funções de segurança personalizadas antigas e desnecessárias. Não pode remover funções de segurança incorporadas. Todos os utilizadores administrativos têm de ter, pelo menos, uma função de segurança. Antes de remover uma função de segurança, certifique-se de que todos os utilizadores têm uma função além da que remove.

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

Este comando remove uma função de segurança denominada MainSecurityRole. O comando utiliza o parâmetro Force , pelo que não lhe pede confirmação.

Remove-CMSecurityRole -Name "MainSecurityRole" -Force

Exemplo 2: Remover uma função de segurança com uma variável

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

O segundo comando remove a primeira função de segurança armazenada na matriz. Uma vez que não especifica o parâmetro Force , este comando pede 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

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 da função de segurança a remover. Este valor é a RoleID propriedade . Uma vez que este cmdlet só funciona com funções personalizadas, este valor deve começar sempre com o código do site. (Os IDs para funções incorporadas 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 remover. Para obter este objeto, utilize 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 remover.

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