Revoke-SCResource
Révoque l’accès à une ressource à partir d’un utilisateur ou d’un rôle d’utilisateur.
Syntax
Revoke-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 Revoke-SCResource révoque l’accès à une ressource d’un utilisateur ou d’un rôle d’utilisateur.
Exemples
Exemple 1 : Révoquer l’accès à une ressource d’un utilisateur spécifique
PS C:\> $Resource = Get-SCVMTemplate | where {$_.Name -eq "Template01"}
PS C:\> Revoke-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 révoque l’accès à la ressource stockée dans $Resource (Template01) de l’utilisateur nommé Katarina. Si l’utilisateur est membre de plusieurs rôles d’utilisateur, l’accès est révoqué de l’utilisateur dans tous ses rôles d’utilisateur.
Exemple 2 : Révoquer l’accès à une ressource d’un utilisateur membre de plusieurs rôles d’utilisateur
PS C:\> $Resource = Get-SCVMTemplate | where {$_.Name -eq "Template01"}
PS C:\> Revoke-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 révoque l’accès à la ressource stockée dans $Resource (Template01) de l’utilisateur nommé Katarina, mais uniquement si l’utilisateur utilise les rôles d’utilisateur ContosoSelfServiceUsers ou SelfServiceUserRole02. Si Katarina utilise un autre rôle d’utilisateur qui a accès à la ressource, elle pourra toujours accéder à la ressource.
Exemple 3 : Révoquer l’accès à une ressource de tous les membres d’un rôle d’utilisateur
PS C:\> $Resource = Get-SCVMTemplate | where {$_.Name -eq "Template01"}
PS C:\> Revoke-SCResource -Resource $Resource -UserRoleName "ContosoSelfServiceUsers"La première commande obtient l’objet de modèle nommé Template01 et stocke l’objet dans la variable $Resource.
La deuxième commande révoque l’accès à la ressource stockée dans $Resource (Template01) de tous 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 .