Revoke-SCResource
从用户或用户角色撤消对资源的访问权限。
语法
Revoke-SCResource
[-VMMServer <ServerConnection>]
-Resource <ClientObject>
[-UserRoleName <String[]>]
[-UserRoleID <Guid[]>]
[-UserName <String>]
[-JobGroup <Guid>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]说明
Revoke-SCResource cmdlet 从用户或用户角色撤消对资源的访问权限。
示例
示例 1：从特定用户撤消对资源的访问权限
PS C:\> $Resource = Get-SCVMTemplate | where {$_.Name -eq "Template01"}
PS C:\> Revoke-SCResource -Resource $Resource -Username "Contoso\Katarina"第一个命令获取名为 Template01 的模板对象，并将该对象存储在$Resource变量中。
第二个命令从名为 Katarina 的用户撤消对存储在 $Resource（Template01）中的资源的访问权限。 如果用户是多个用户角色的成员，将在其所有用户角色中从该用户撤消访问权限。
示例 2：从属于多个用户角色的用户撤消对资源的访问权限
PS C:\> $Resource = Get-SCVMTemplate | where {$_.Name -eq "Template01"}
PS C:\> Revoke-SCResource -Resource $Resource -Username "Contoso\Katarina" -UserRoleName @("ContosoSelfServiceUsers", "SelfServiceUserRole02")第一个命令获取名为 Template01 的模板对象，并将该对象存储在$Resource变量中。
第二个命令从名为 Katarina 的用户撤消对存储在 $Resource（Template01）中的资源的访问权限，但前提是用户使用的是 ContosoSelfServiceUsers 或 SelfServiceUserRole02 用户角色。 如果 Katarina 使用有权访问资源的其他用户角色，则她仍然可以访问资源。
示例 3：从用户角色的所有成员撤消对资源的访问权限
PS C:\> $Resource = Get-SCVMTemplate | where {$_.Name -eq "Template01"}
PS C:\> Revoke-SCResource -Resource $Resource -UserRoleName "ContosoSelfServiceUsers"第一个命令获取名为 Template01 的模板对象，并将该对象存储在$Resource变量中。
第二个命令从 ContosoSelfServiceUsers 用户角色的所有成员撤消对存储在 $Resource（Template01）中的资源的访问权限。
参数
-JobGroup
指定一系列命令的标识符，该命令将在包含相同作业组标识符的最终命令运行之前作为集运行。
| 类型: | Guid |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-JobVariable
指定在此参数命名的变量中跟踪和存储作业进度。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-OnBehalfOfUser
指定用户名。 此 cmdlet 代表此参数指定的用户运行。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-OnBehalfOfUserRole
指定用户角色。 若要获取用户角色，请使用 Get-SCUserRole cmdlet。 此 cmdlet 代表此参数指定的用户角色运行。
| 类型: | UserRole |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-PROTipID
指定触发此操作的性能和资源优化提示（PRO 提示）的 ID。 此参数允许你审核 PRO 提示。
| 类型: | Guid |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Resource
指定资源对象。
| 类型: | ClientObject |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | True |
| 接受通配符: | False |
-RunAsynchronously
指示作业以异步方式运行，以便控件立即返回到命令行界面。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-UserName
指定用户的名称。 输入格式为 Domain\User 的用户名。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-UserRoleID
指定用户角色的 ID。
| 类型: | Guid[] |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-UserRoleName
指定用户角色的名称。 命名的用户角色类型包括委派管理员、Read-Only 管理员和 Self-Service 用户。
| 类型: | String[] |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-VMMServer
指定 VMM 服务器对象。
| 类型: | ServerConnection |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
输出
Resource
此 cmdlet 返回 Resource 对象。