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 对象。