Grant-SCResource
授與使用者或自助使用者角色對資源的存取權。
Syntax
Grant-SCResource
[-VMMServer <ServerConnection>]
-Resource <ClientObject>
[-UserRoleName <String[]>]
[-UserRoleID <Guid[]>]
[-UserName <String>]
[-JobGroup <Guid>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]Description
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變數中。
第二個命令會將儲存在 template01 $Resource (中的資源與名為 Kata) 的使用者共用。 如果使用者是具有接收許可權的多個自助使用者角色的成員，則必須指定使用者角色。
範例 2：與屬於多個使用者角色成員的使用者共用資源
PS C:\> $Resource = Get-SCVMTemplate | where {$_.Name -eq "Template01"}
PS C:\> Grant-SCResource -Resource $Resource -Username "Contoso\Katarina" -UserRoleName @("ContosoSelfServiceUsers", "SelfServiceUserRole02")第一個命令會取得名為 Template01 的範本物件，並將物件儲存在$Resource變數中。
第二個命令會將儲存在 $Resource (Template01 中的資源與名為Kata的使用者共用) ，但只有在該使用者正在使用 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：使用使用者角色識別碼與使用者角色的所有成員共用資源
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 提示 (PRO 提示的識別碼) 。 此參數可讓您稽核 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
表示作業會以非同步方式執行，讓控制項立即返回命令殼層。
| 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
指定使用者角色的識別碼。
| 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 物件。