Partager via


New-SCUserRole

Crée un rôle d’utilisateur pour un groupe d’utilisateurs VMM.

Syntax

New-SCUserRole
   [-VMMServer <ServerConnection>]
   [-Name] <String>
   -UserRoleProfile <Profile>
   [-ID <Guid>]
   [-JobGroup <Guid>]
   [-Description <String>]
   [-ParentUserRole <UserRole>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Description

L’applet de commande New-SCUserRole crée un rôle d’utilisateur pour un groupe d’utilisateurs VMM (Virtual Machine Manager). Vous pouvez créer les rôles d’utilisateur suivants : Administrateur délégué, administrateur Read-Only, administrateur de machine virtuelle et Self-Service utilisateur. Un seul rôle d’administrateur existe. Vous ne pouvez pas créer un autre rôle d’administrateur ou supprimer celui existant.

Si vous êtes membre d’un rôle d’utilisateur Administrateur délégué, vous pouvez créer un rôle d’utilisateur. Toutefois, l’étendue du nouveau rôle d’utilisateur doit être un sous-ensemble de l’étendue de son rôle d’utilisateur parent.

Après avoir créé un rôle d’utilisateur, vous pouvez utiliser l’applet de commande Set-SCUserRole pour renommer le rôle d’utilisateur, ajouter ou supprimer des membres, et ajouter ou modifier l’étendue des objets que les membres du rôle peuvent gérer. Pour un rôle d’utilisateur Self-Service, vous pouvez spécifier les actions que les membres d’un rôle d’utilisateur Self-Service peuvent prendre sur leurs machines virtuelles, et vous pouvez définir un quota qui limite le nombre d’utilisateurs libre-service des machines virtuelles. Bien que vous ne puissiez pas créer ou supprimer le rôle Administrateur ou limiter son étendue, vous pouvez utiliser Set-SCUserRole pour ajouter ou supprimer des membres à ce rôle.

Pour plus d’informations sur la modification des propriétés d’un rôle d’utilisateur, tapez Get-Help Set-SCUserRole.

Exemples

Exemple 1 : Créer un rôle d’utilisateur Administrateur délégué

PS C:\> New-SCUserRole -Name "ContosoDelegatedAdmin" -Description "Delegated Administrators for the Contoso.com domain" -UserRoleProfile "DelegatedAdmin"

Cette commande crée un rôle d’utilisateur administrateur délégué nommé ContosoDelegatedAdmin, fournit la description des administrateurs délégués pour le domaine Contoso.com et utilise le paramètre UserRoleProfile pour désigner le type de rôle utilisateur en tant qu’administrateur délégué.

Exemple 2 : Créer un rôle d’utilisateur libre-service

PS C:\> $SelfServiceRole = New-SCUserRole -Name "ContosoSelfServiceUsers" -UserRoleProfile "SelfServiceUser"

Cette commande crée un rôle d’utilisateur nommé ContosoSelfServiceUsers, utilise le paramètre UserRoleProfile pour désigner le nouveau type de rôle utilisateur en tant qu’utilisateur Self-Service et stocke le nouvel objet de rôle d’utilisateur dans la variable $SelfServiceRole.

Exemple 3 : Créer un rôle Administrateur de machine virtuelle

PS C:\> New-SCUserRole -Name "VirtualMachineAdmin" -UserRoleProfile "VMAdmin" -Description "Virtual Machine administrator for contoso.com domain"

Cette commande crée un rôle d’utilisateur administrateur de machine virtuelle nommé VirtualMachineAdmin, fournit la description « Administrateur de machine virtuelle pour contoso.com domaine » et utilise le paramètre UserRoleProfile pour désigner le type de rôle utilisateur en tant que VMAdmin.

Paramètres

-Description

Spécifie une description du rôle d’utilisateur.

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

-ID

Spécifie l’ID unique du nouveau rôle d’utilisateur.

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

-JobGroup

Spécifie un identificateur pour une série de commandes qui s’exécute en tant que jeu juste avant la commande finale qui inclut le même identificateur de groupe de travaux.

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

-JobVariable

Spécifie une variable dans laquelle la progression du travail est suivie et stockée.

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

-Name

Spécifie un nom pour le nouveau rôle d’utilisateur.

Type:String
Position:0
Default value:None
Required:True
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 spécifié par ce paramètre.

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

-ParentUserRole

Spécifie un rôle d’utilisateur VMM existant en tant que parent du nouveau rôle d’utilisateur.

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

-PROTipID

Spécifie l’ID de l’info-bulle d’optimisation des performances et des ressources (CONSEIL PRO) qui a déclenché cette action. Ce paramètre vous permet d’auditer les conseils PRO.

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

-RunAsynchronously

Indique que le travail s’exécute de manière asynchrone afin que le contrôle retourne immédiatement à l’interpréteur de commandes.

Type:SwitchParameter
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 du nouveau rôle d’utilisateur. Les valeurs valides pour ce paramètre sont :

  • DelegatedAdmin
  • ReadOnlyAdmin
  • SelfServiceUser
  • TenantAdmin
  • VMAdmin
Type:Profile
Accepted values:Administrator, DelegatedAdmin, VMAdmin, TenantAdmin, SelfServiceUser, ReadOnlyAdmin
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-VMMServer

Spécifie le serveur VMM sur lequel cette applet de commande crée un rôle 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 .