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 コマンドレットは、ユーザーまたはセルフサービス ユーザー ロールにリソースへのアクセスを許可します。
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 変数に格納します。
2 番目のコマンドは、$Resource (Template01) に格納されているリソースを Katarina というユーザーと共有します。 ユーザーが、受信アクセス許可を持つ複数のセルフサービス ユーザー ロールのメンバーである場合は、ユーザー ロールを指定する必要があります。
例 2: 複数のユーザー ロールのメンバーであるユーザーとリソースを共有する
PS C:\> $Resource = Get-SCVMTemplate | where {$_.Name -eq "Template01"}
PS C:\> Grant-SCResource -Resource $Resource -Username "Contoso\Katarina" -UserRoleName @("ContosoSelfServiceUsers", "SelfServiceUserRole02")最初のコマンドは Template01 という名前のテンプレート オブジェクトを取得し、そのオブジェクトを $Resource 変数に格納します。
2 番目のコマンドは、$Resource (Template01) に格納されているリソースを Katarina というユーザーと共有しますが、そのユーザーが ContosoSelfServiceUsers または SelfServiceUserRole02 ユーザー ロールを使用している間のみ共有します。
例 3: ユーザー ロールのすべてのメンバーとリソースを共有する
PS C:\> $Resource = Get-SCVMTemplate | where {$_.Name -eq "VMTemplate01"}
PS C:\> Grant-SCResource -Resource $Resource -UserRoleName "ContosoSelfServiceUsers"最初のコマンドは、VMTemplate01 という名前のテンプレート オブジェクトを取得し、そのオブジェクトを $Resource 変数に格納します。
2 番目のコマンドは、$Resource (VMTemplate01) に格納されているリソースを ContosoSelfServiceUsers という名前のユーザー ロールのメンバーと共有します。
例 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 変数に格納します。
2 番目のコマンドは、ContosoSelfServiceUsers という名前のユーザー ロール オブジェクトを取得し、そのオブジェクトを $UserRole 変数に格納します。
最後のコマンドは、$Resource (VMTemplate01) に格納されているリソースをユーザー ロール ContosoSelfServiceUsers のメンバーと共有します。
パラメーター
-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
ユーザー名を指定します。 このコマンドレットは、このパラメーターで指定されたユーザーの代わりに動作します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OnBehalfOfUserRole
ユーザー ロールを指定します。 ユーザー ロールを取得するには、 Get-SCUserRole コマンドレットを 使用します。 このコマンドレットは、このパラメーターが指定するユーザー ロールの代わりに動作します。
| 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
コントロールがコマンド シェルに直ちに戻るように、ジョブが非同期的に実行されることを示します。
| 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
このコマンドレットは 、Resource オブジェクトを返します。