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 .