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 的用户撤消对存储在 template01) $Resource (中的资源的访问权限。 如果用户是多个用户角色的成员，则会在其所有用户角色中从用户撤消访问权限。
示例 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 的用户撤消对存储在 template01) $Resource (中的资源的访问权限，但前提是用户使用的是 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
在运行最后一个包含相同作业组标识符的命令之前，为作为集合运行的一系列命令指定标识符。
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-JobVariable
指定跟踪作业进度，并将其存储在此参数命名的变量中。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OnBehalfOfUser
指定用户名。 此 cmdlet 代表此参数指定的用户操作。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OnBehalfOfUserRole
指定用户角色。 若要获取用户角色，请使用 Get-SCUserRole cmdlet。 此 cmdlet 代表此参数指定的用户角色进行操作。
| Type: | UserRole |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PROTipID
指定触发此操作 (PRO 提示) 的性能和资源优化提示的 ID。 此参数允许审核 PRO 提示。
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Resource
指定资源对象。
| Type: | ClientObject |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-RunAsynchronously
指示作业以异步方式运行，以便控件立即返回到命令 shell。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UserName
指定用户的名称。 输入格式为 Domain\User 的用户名。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UserRoleID
指定用户角色的 ID。
| Type: | Guid[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UserRoleName
指定用户角色的名称。 命名的用户角色类型包括委派管理员、Read-Only管理员和Self-Service用户。
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VMMServer
指定VMM 服务器对象。
| Type: | ServerConnection |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
输出
Resource
此 cmdlet 返回 Resource 对象。