Partager via

Grant-SCResource

  • Référence
Module:
VirtualMachineManager

Accorde à un utilisateur ou un rôle d’utilisateur libre-service l’accès à une ressource.

Syntaxe

Grant-SCResource
     [-VMMServer <ServerConnection>]
     -Resource <ClientObject>
     [-UserRoleName <String[]>]
     [-UserRoleID <Guid[]>]
     [-UserName <String>]
     [-JobGroup <Guid>]
     [-RunAsynchronously]
     [-PROTipID <Guid>]
     [-JobVariable <String>]
     [-OnBehalfOfUser <String>]
     [-OnBehalfOfUserRole <UserRole>]
     [<CommonParameters>]

Description

L’applet de commande Grant-SCResource accorde à un utilisateur ou un rôle d’utilisateur libre-service l’accès à une ressource.

Les types de ressources que vous pouvez partager à l’aide de Grant-SCResource incluent les éléments suivants :

  • Modèles de service

  • Modèles de machine virtuelle

  • Profils de système d’exploitation invité

  • Profils SQL Server

  • Profils matériels

  • Profils d’application

  • Services

  • Machines virtuelles

Exemples

Exemple 1 : Partager une ressource avec un utilisateur spécifique

PS C:\> $Resource = Get-SCVMTemplate | where {$_.Name -eq "Template01"}
PS C:\> Grant-SCResource -Resource $Resource -Username "Contoso\Katarina"

La première commande obtient l’objet de modèle nommé Template01 et stocke l’objet dans la variable $Resource.

La deuxième commande partage la ressource stockée dans $Resource (Template01) avec l’utilisateur nommé Katarina. Si l’utilisateur est membre de plusieurs rôles d’utilisateur libre-service disposant d’une autorisation de réception, un rôle d’utilisateur doit être spécifié.

Exemple 2 : Partager une ressource avec un utilisateur membre de plusieurs rôles d’utilisateur

PS C:\> $Resource = Get-SCVMTemplate | where {$_.Name -eq "Template01"}
PS C:\> Grant-SCResource -Resource $Resource -Username "Contoso\Katarina" -UserRoleName @("ContosoSelfServiceUsers", "SelfServiceUserRole02")

La première commande obtient l’objet de modèle nommé Template01 et stocke l’objet dans la variable $Resource.

La deuxième commande partage la ressource stockée dans $Resource (Template01) avec l’utilisateur nommé Katarina, mais uniquement pendant que cet utilisateur utilise les rôles d’utilisateur ContosoSelfServiceUsers ou SelfServiceUserRole02.

Exemple 3 : Partager une ressource avec tous les membres d’un rôle d’utilisateur

PS C:\> $Resource = Get-SCVMTemplate | where {$_.Name -eq "VMTemplate01"}
PS C:\> Grant-SCResource -Resource $Resource -UserRoleName "ContosoSelfServiceUsers"

La première commande obtient l’objet de modèle nommé VMTemplate01 et stocke l’objet dans la variable $Resource.

La deuxième commande partage la ressource stockée dans $Resource (VMTemplate01) avec les membres du rôle d’utilisateur nommé ContosoSelfServiceUsers.

Exemple 4 : Partager une ressource avec tous les membres d’un rôle d’utilisateur à l’aide de l’ID de rôle d’utilisateur

PS C:\> $Resource = Get-SCVMTemplate | where {$_.Name -eq "VMTemplate01"}
PS C:\> $UserRole = Get-SCUserRole -Name "ContosoSelfServiceUsers"
PS C:\> Grant-SCResource -Resource $Resource -UserRoleId $UserRole.Id

La première commande obtient l’objet de modèle nommé VMTemplate01 et stocke l’objet dans la variable $Resource.

La deuxième commande obtient l’objet de rôle d’utilisateur nommé ContosoSelfServiceUsers et stocke l’objet dans la variable $UserRole.

La dernière commande partage la ressource stockée dans $Resource (VMTemplate01) avec les membres du rôle d’utilisateur ContosoSelfServiceUsers.

Paramètres

-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 que la progression du travail est suivie et stockée dans la variable nommée par ce paramètre.

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

-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

-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

-Resource

Spécifie un objet de ressource.

Type:ClientObject
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
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

-UserName

Spécifie un nom d’utilisateur. Entrez un nom d’utilisateur au format Domaine\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

-UserRoleID

Spécifie l’ID d’un 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

-UserRoleName

Spécifie le nom d’un rôle d’utilisateur. Les types de rôles d’utilisateur nommés incluent l’administrateur délégué, l’administrateur Read-Only et l’utilisateur Self-Service.

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

-VMMServer

Spécifie un objet serveur VMM.

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

Sorties

Resource

Cette applet de commande retourne un objet Resource.