Partager via

Grant-SCResource

  • Référence
Module:
VirtualMachineManager

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

Syntax

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 sont les suivants :

  • Modèles de service

  • Modèles d'ordinateur virtuel

  • profils de système d'exploitation invité ;

  • profils de 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 seront exécutées ensemble juste avant que la commande finale qui comprend le même identificateur de groupe de travaux soit exécutée.

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

-JobVariable

Spécifie que la progression des travaux est suivie et stockée dans la variable nommée par ce paramètre.

Type:String
Position:Named
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 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

-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

-Resource

Spécifie un objet de ressource.

Type:ClientObject
Position:Named
Default value:None
Required:True
Accept pipeline input:True
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

-UserName

Spécifie le nom d’un utilisateur. Entrez un nom d’utilisateur au format Domaine\Utilisateur.

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

-UserRoleID

Spécifie l’ID d’un rôle d’utilisateur.

Type:Guid[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VMMServer

Spécifie un objet serveur VMM.

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

Sorties

Resource

Cette applet de commande retourne un objet Resource .