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
同じジョブ グループ識別子を含む最後のコマンドが実行される直前にセットとして実行される一連のコマンドの識別子を指定します。
| 型: | Guid |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-JobVariable
ジョブの進行状況を追跡し、このパラメーターによって指定された変数に格納することを指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-OnBehalfOfUser
ユーザー名を指定します。 このコマンドレットは、このパラメーターが指定したユーザーに代わって動作します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-OnBehalfOfUserRole
ユーザー ロールを指定します。 ユーザー ロールを取得するには、Get-SCUserRole コマンドレットを使用します。 このコマンドレットは、このパラメーターが指定するユーザー ロールに代わって動作します。
| 型: | UserRole |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-PROTipID
このアクションをトリガーしたパフォーマンスとリソースの最適化のヒント (PRO ヒント) の ID を指定します。 このパラメーターを使用すると、PRO のヒントを監査できます。
| 型: | Guid |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Resource
リソース オブジェクトを指定します。
| 型: | ClientObject |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-RunAsynchronously
コントロールがコマンド シェルにすぐに戻るように、ジョブが非同期的に実行されることを示します。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-UserName
ユーザーの名前を指定します。 Domain\User という形式のユーザー名を入力します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-UserRoleID
ユーザー ロールの ID を指定します。
| 型: | Guid[] |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-UserRoleName
ユーザー ロールの名前を指定します。 名前付きのユーザー ロールの種類には、委任された管理者、Read-Only 管理者、Self-Service ユーザーが含まれます。
| 型: | String[] |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-VMMServer
VMM サーバー オブジェクトを指定します。
| 型: | ServerConnection |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
出力
Resource
このコマンドレットは、Resource オブジェクトを返します。