Partager via

Get-SCUserRole

  • Référence
Module:
VirtualMachineManager

Obtient un rôle d’utilisateur VMM.

Syntax

Get-SCUserRole
   [-VMMServer <ServerConnection>]
   [[-Name] <String>]
   [-UserRoleProfile <Profile>]
   [-ID <Guid>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Description

L’applet de commande Get-SCUserRole obtient un ou plusieurs rôles d’utilisateur Virtual Machine Manager (VMM). VMM utilise la sécurité basée sur le rôle pour définir les limites dans lesquelles les membres d’un rôle d’utilisateur donné peuvent fonctionner et l’ensemble des opérations autorisées d’un rôle d’utilisateur peut effectuer.

Pour plus d’informations sur la création de rôles d’utilisateur, tapez Get-Help New-SCUserRole.

Pour plus d’informations sur la définition des propriétés d’un rôle d’utilisateur, notamment l’étendue des administrateurs délégués et en lecture seule et l’étendue et les actions pour les utilisateurs en libre-service, tapez Get-Help Set-SCUserRole.

Exemples

Exemple 1 : Obtenir tous les rôles d’utilisateur

PS C:\> Get-SCUserRole -VMMServer "VMMServer01.Contoso.com"

Cette commande obtient tous les rôles d’utilisateur VMM sur le serveur nommé VMMServer01.Contoso.com. La commande affiche des informations sur chaque rôle d’utilisateur.

Exemple 2 : Obtenir un rôle d’utilisateur par nom

PS C:\> Get-SCUserRole -Name "Administrator"

Cette commande obtient l’objet de rôle utilisateur nommé Administrateur. La commande affiche des informations sur ce rôle d’utilisateur.

Exemple 3 : Obtenir un rôle d’utilisateur par profil

PS C:\> Get-SCUserRole -VMMServer "VMMServer01.Contoso.com" -UserRoleProfile "SelfServiceUser"

Cette commande obtient les rôles d’utilisateur que le serveur nommé VMMServer01 possède un profil de rôle d’utilisateur de SelfServiceUser. La commande affiche des informations sur ces rôles d’utilisateur.

Exemple 4 : Afficher des propriétés et d’autres informations sur les objets de rôle utilisateur

PS C:\> $UserRoles = Get-SCUserRole -VMMServer "VMMServer01.Contoso.com"
PS C:\> $UserRoles | Select-Object -Property Name, UserRoleProfile, ParentUserRole, Cloud
PS C:\> $UserRoles | Get-Member

La première commande obtient tous les objets de rôle utilisateur sur le serveur nommé VMMServer01, puis stocke ces objets dans la variable $UserRoles.

La deuxième commande transmet chaque objet de rôle d’utilisateur dans $UserRoles à l’applet de commande Select-Object, qui affiche ensuite le nom, le profil de rôle d’utilisateur, le rôle d’utilisateur parent et le cloud pour chaque rôle d’utilisateur

La commande finale transmet chaque rôle d’utilisateur dans $UserRoles à l’applet de commande Get-Member , qui affiche le type .NET pour chaque rôle d’utilisateur et les méthodes et propriétés associées à chaque type de rôle d’utilisateur.

Paramètres

-ID

Spécifie l’ID unique du rôle d’utilisateur que cette applet de commande obtient.

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Spécifie le nom du rôle d’utilisateur VMM que cette applet de commande obtient.

Type:String
Position:0
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OnBehalfOfUser

Spécifie un nom d'utilisateur. Cette applet de commande fonctionne pour le compte de l’utilisateur que ce paramètre spécifie.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OnBehalfOfUserRole

Spécifie un rôle d’utilisateur. Pour obtenir un rôle d’utilisateur, utilisez l’applet de commande Get-SCUserRole . Cette applet de commande fonctionne pour le compte du rôle d’utilisateur spécifié par ce paramètre.

Type:UserRole
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UserRoleProfile

Spécifie le type de profil qui est la base des rôles d’utilisateur que cette applet de commande obtient. Les valeurs valides pour ce paramètre sont :

  • DéléguédAdmin
  • ReadOnlyAdmin
  • SelfServiceUser
Type:Profile
Accepted values:Administrator, DelegatedAdmin, TenantAdmin, SelfServiceUser, ReadOnlyAdmin
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VMMServer

Spécifie le serveur VMM sur lequel cette applet de commande obtient des rôles d’utilisateur.

Type:ServerConnection
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

Sorties

UserRole

Cette applet de commande retourne un objet UserRole .