Update-SCSMUserRole
Define a propriedade UserRole para um usuário do Service Manager.
Sintaxe
Default (Padrão)
Update-SCSMUserRole
[-UserRole] <Role[]>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
O cmdlet
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-SCSMUserRolee, em seguida, a armazena na variável $Role.
O segundo comando obtém um usuário usando o cmdlet Get-SCSMUser e 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 os administradores.
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 |
-PassThru
Indica que esse cmdlet retorna a função de usuário que ele atualiza. Você pode passar esse objeto para outros cmdlets.
Propriedades do parâmetro
| Tipo: | System.Management.Automation.SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
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 ao qual adicionar 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 um objeto UserRole
Saídas
None.
Esse cmdlet não gera nenhuma saída.