Grant-SCResource
授予用户或自助服务用户角色对资源的访问权限。
语法
Grant-SCResource
[-VMMServer <ServerConnection>]
-Resource <ClientObject>
[-UserRoleName <String[]>]
[-UserRoleID <Guid[]>]
[-UserName <String>]
[-JobGroup <Guid>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]说明
Grant-SCResource cmdlet 授予用户或自助服务用户角色对资源的访问权限。
可以使用 Grant-SCResource 共享的资源类型包括：
服务模板
虚拟机模板
来宾操作系统配置文件
SQL Server配置文件
硬件配置文件
应用程序配置文件
服务
虚拟机
示例
示例 1：与特定用户共享资源
PS C:\> $Resource = Get-SCVMTemplate | where {$_.Name -eq "Template01"}
PS C:\> Grant-SCResource -Resource $Resource -Username "Contoso\Katarina"第一个命令获取名为 Template01 的模板对象，并将对象存储在$Resource变量中。
第二个命令与名为 Katarina 的用户共享存储在 $Resource (Template01 中的资源) 。 如果用户是具有接收权限的多个自助服务用户角色的成员，则必须指定用户角色。
示例 2：与属于多个用户角色成员的用户共享资源
PS C:\> $Resource = Get-SCVMTemplate | where {$_.Name -eq "Template01"}
PS C:\> Grant-SCResource -Resource $Resource -Username "Contoso\Katarina" -UserRoleName @("ContosoSelfServiceUsers", "SelfServiceUserRole02")第一个命令获取名为 Template01 的模板对象，并将对象存储在$Resource变量中。
第二个命令与名为 Katarina 的用户共享存储在 $Resource (Template01) 中的资源，但仅当该用户正在使用 ContosoSelfServiceUsers 或 SelfServiceUserRole02 用户角色时。
示例 3：与用户角色的所有成员共享资源
PS C:\> $Resource = Get-SCVMTemplate | where {$_.Name -eq "VMTemplate01"}
PS C:\> Grant-SCResource -Resource $Resource -UserRoleName "ContosoSelfServiceUsers"第一个命令获取名为 VMTemplate01 的模板对象，并将对象存储在$Resource变量中。
第二个命令与名为 ContosoSelfServiceUsers 的用户角色的成员共享存储在 $Resource (VMTemplate01) 中的资源。
示例 4：使用用户角色 ID 与用户角色的所有成员共享资源
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第一个命令获取名为 VMTemplate01 的模板对象，并将对象存储在$Resource变量中。
第二个命令获取名为 ContosoSelfServiceUsers 的用户角色对象，并将对象存储在$UserRole变量中。
最后一个命令与用户角色 ContosoSelfServiceUsers 的成员共享存储在 $Resource (VMTemplate01) 中的资源。
参数
-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 对象。