Partager via


Update-SCSMUserRole

Définit la propriété UserRole pour un utilisateur Service Manager.

Syntaxe

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

Description

L’applet de commande Update-SCSMUserRole définit la propriété UserRole pour un utilisateur Service Manager.

Exemples

Exemple 1 : Ajouter un utilisateur à un rôle d’utilisateur

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

La première commande obtient le rôle d’utilisateur nommé IncidentResolvers à l’aide de Get-SCSMUserRole, puis la stocke dans la variable $Role.

La deuxième commande obtient un utilisateur à l’aide de l’applet de commande Get-SCSMUser, puis stocke cet objet dans la variable $User.

La troisième commande ajoute $User à la propriété User de $Role.

La commande finale met à jour le rôle pour qu’il corresponde à la valeur actuelle de $Role.

Exemple 2 : Supprimer un utilisateur d’un rôle

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

Cet exemple supprime un utilisateur d’un rôle d’utilisateur. La première commande affiche les administrateurs.

Paramètres

-Confirm

Vous invite à confirmer avant d’exécuter l’applet de commande.

Type:System.Management.Automation.SwitchParameter
Alias:cf
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-PassThru

Indique que cette applet de commande retourne le rôle d’utilisateur qu’elle met à jour. Vous pouvez transmettre cet objet à d’autres applets de commande.

Type:System.Management.Automation.SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-UserRole

Spécifie l’objet UserRole auquel ajouter l’utilisateur.

Type:Microsoft.EnterpriseManagement.ServiceManager.Sdk.UserRoles.Role[]
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande n’est pas exécutée.

Type:System.Management.Automation.SwitchParameter
Alias:wi
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

Microsoft.EnterpriseManagement.ServiceManager.Sdk.UserRoles.Role

Vous pouvez diriger un objet UserRole vers le paramètre UserRole. Pour obtenir un rôle d’utilisateur, utilisez l’applet de commande Get-SCSMUserRole.

Sorties

None.

Cette applet de commande ne génère aucune sortie.