New-SCUserRole
Crée un rôle d’utilisateur pour un groupe d’utilisateurs VMM.
Syntaxe
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
La cmdlet 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 utilisateur Self-Service. Il n’existe qu’un seul rôle Administrateur. 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 la cmdlet 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 définir un quota qui limite le nombre d’utilisateurs en 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 d’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 nouveau rôle d’utilisateur nommé ContosoSelfServiceUsers, utilise le paramètre UserRoleProfile pour désigner le nouveau type de rôle d’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 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-ID
Spécifie l’ID unique du nouveau rôle d’utilisateur.
| Type: | Guid |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | 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 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-JobVariable
Spécifie une variable dans laquelle la progression du travail est suivie et stockée.
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Name
Spécifie un nom pour le nouveau rôle d’utilisateur.
| Type: | String |
| Position: | 0 |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | 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 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-OnBehalfOfUserRole
Spécifie un rôle d’utilisateur. Pour obtenir un rôle d’utilisateur, utilisez la cmdlet 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 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | 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 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | 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 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-RunAsynchronously
Indique que le travail s’exécute de façon asynchrone afin que le contrôle retourne immédiatement à l’interpréteur de commandes.
| Type: | 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 |
-UserRoleProfile
Spécifie le type de profil qui est la base du nouveau rôle d’utilisateur. Les valeurs acceptables pour ce paramètre sont les suivantes :
- DelegatedAdmin
- ReadOnlyAdmin
- SelfServiceUser
- TenantAdmin
- VMAdmin
| Type: | Profile |
| Valeurs acceptées: | Administrator, DelegatedAdmin, VMAdmin, TenantAdmin, SelfServiceUser, ReadOnlyAdmin |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-VMMServer
Spécifie le serveur VMM sur lequel cette applet de commande crée un rôle d’utilisateur.
| Type: | ServerConnection |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
Sorties
UserRole
Cette applet de commande retourne un objet UserRole.