Compartilhar via


Remove-SCSMUserRole

Remove uma função de usuário do Service Manager.

Sintaxe

Default (Padrão)

Remove-SCSMUserRole
    [-UserRole] <Role[]>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

O cmdlet Remove-SCSMUserRole do remove uma função de usuário do Service Manager. Algumas funções de usuário são designadas como funções de usuário do sistema e não podem ser removidas. Você pode executar o comando a seguir para exibir o issystem atributo de todos os objetos de função de usuário.

Get-SCSMUserRole | Format-Table -Property DisplayName,{$_.userrole.issystem} -AutoSize

Se a função de usuário não puder ser removida, esse cmdlet retornará um erro de não encerramento.

Exemplos

Exemplo 1: remover uma função de usuário

PS C:\>Get-SCSMUserRole -Name "CustomUser" | Remove-SCSMUserRole

Esse comando obtém a função de usuário chamada CustomUser usando o cmdlet Get-SCSMUserRole. O comando passa esse objeto para o cmdlet atual usando o operador de pipeline. Esse cmdlet exclui essa função de usuário.

Parâmetros

-Confirm

Solicita a confirmação antes de executar o cmdlet.

Propriedades do parâmetro

Tipo:System.Management.Automation.SwitchParameter
Valor padrão:False
Dá suporte a curingas:False
DontShow:False
Aliases:cf

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-UserRole

Especifica o objeto UserRole do qual remover o usuário.

Propriedades do parâmetro

Tipo:

Microsoft.EnterpriseManagement.ServiceManager.Sdk.UserRoles.Role[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:0
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-WhatIf

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

Propriedades do parâmetro

Tipo:System.Management.Automation.SwitchParameter
Valor padrão:False
Dá suporte a curingas:False
DontShow:False
Aliases:wi

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Entradas

Microsoft.EnterpriseManagement.ServiceManager.Sdk.UserRoles.Role

Você pode canalizar uma função de usuário para o parâmetro UserRole. Por exemplo, um objeto como o retornado pelo cmdlet Get-SCSMUserRole.

Saídas

None.

Esse cmdlet não gera nenhuma saída.