次の方法で共有


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 オブジェクトを返します。