Partilhar via

Update-SCSMUserRole

  • Referência
Módulo:
System.Center.Service.Manager

Define a propriedade UserRole para um usuário do Service Manager.

Sintaxe

Update-SCSMUserRole
      [-UserRole] <Role[]>
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

O cmdlet Update-SCSMUserRole define a propriedade UserRole para um usuário do Service Manager.

Exemplos

Exemplo 1: Adicionar um usuário a uma função de usuário

PS C:\>$Role = Get-SCSMUserRole -Name "IncidentResolvers"
PS C:\> $User = Get-SCSMUser -UserName "PattiFuller"
PS C:\> $Role.User += $User
PS C:\> Update-SCSMUserRole -Role $Role

O primeiro comando obtém a função de usuário chamada IncidentResolvers usando Get-SCSMUserRole e, em seguida, armazena-a na variável $Role.

O segundo comando obtém um usuário usando o cmdlet Get-SCSMUser e, em seguida, armazena esse objeto na variável $User.

O terceiro comando acrescenta $User à propriedade User de $Role.

O comando final atualiza a função para corresponder ao valor atual de $Role.

Exemplo 2: Remover um usuário de uma função

PS C:\>Get-SCSMUserRole -Name "Administrators"
WOODGROVE\Administrator
WOODGROVE\Domain Admins


The second command assigns the user role previously displayed to the $Role variable. 
PS C:\>$Role = Get-SCSMUserRole -Name "Administrators"

The third command assigns the first user role to the **User** property of $Role. This command that property, removing all except the specified user. 
PS C:\>$Role.User = $Role.Users[0]

The final command updates the role to match the current value of $Role.
PS C:\>Update-SCSMUserRole -Role $Role

Este exemplo remove um usuário de uma função de usuário. O primeiro comando exibe administradores.

Parâmetros

-Confirm

Solicita confirmação antes de executar o cmdlet.

Tipo:System.Management.Automation.SwitchParameter
Aliases:cf
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-PassThru

Indica que esse cmdlet retorna a função de usuário que ele atualiza. Você pode passar esse objeto para outros cmdlets.

Tipo:System.Management.Automation.SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-UserRole

Especifica o UserRole objeto ao qual adicionar o usuário.

Tipo:Microsoft.EnterpriseManagement.ServiceManager.Sdk.UserRoles.Role[]
Position:0
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-WhatIf

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

Tipo:System.Management.Automation.SwitchParameter
Aliases:wi
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

Entradas

Microsoft.EnterpriseManagement.ServiceManager.Sdk.UserRoles.Role

Você pode canalizar um objeto UserRole para o parâmetro UserRole. Para obter uma função de usuário, use o cmdlet Get-SCSMUserRole.

Saídas

None.

Este cmdlet não gera nenhuma saída.