Revoke-SCResource

  • リファレンス
モジュール:
VirtualMachineManager

ユーザーまたはユーザー ロールからリソースへのアクセスを取り消します。

構文

Revoke-SCResource
      [-VMMServer <ServerConnection>]
      -Resource <ClientObject>
      [-UserRoleName <String[]>]
      [-UserRoleID <Guid[]>]
      [-UserName <String>]
      [-JobGroup <Guid>]
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-OnBehalfOfUser <String>]
      [-OnBehalfOfUserRole <UserRole>]
      [<CommonParameters>]

説明

Revoke-SCResource コマンドレットは、ユーザーまたはユーザー ロールからリソースへのアクセスを取り消します。

例

例 1: 特定のユーザーからリソースへのアクセスを取り消す

PS C:\> $Resource = Get-SCVMTemplate | where {$_.Name -eq "Template01"} 
PS C:\> Revoke-SCResource -Resource $Resource -Username "Contoso\Katarina"

最初のコマンドは、Template01 という名前のテンプレート オブジェクトを取得し、$Resource変数にオブジェクトを格納します。

2 番目のコマンドは、Katarina という名前のユーザーから、$Resource (Template01) に格納されているリソースへのアクセスを取り消します。 ユーザーが複数のユーザー ロールのメンバーである場合、すべてのユーザー ロールのユーザーからアクセスが取り消されます。

例 2: 複数のユーザー ロールのメンバーであるユーザーからリソースへのアクセスを取り消す

PS C:\> $Resource = Get-SCVMTemplate | where {$_.Name -eq "Template01"}
PS C:\> Revoke-SCResource -Resource $Resource -Username "Contoso\Katarina" -UserRoleName @("ContosoSelfServiceUsers", "SelfServiceUserRole02")

最初のコマンドは、Template01 という名前のテンプレート オブジェクトを取得し、$Resource変数にオブジェクトを格納します。

2 番目のコマンドは、ユーザーが ContosoSelfServiceUsers または SelfServiceUserRole02 ユーザー ロールを使用している場合にのみ、Katarina という名前のユーザーから、$Resource (Template01) に格納されているリソースへのアクセスを取り消します。 Katarina がリソースにアクセスできる別のユーザー ロールを使用している場合でも、リソースにアクセスできます。

例 3: ユーザー ロールのすべてのメンバーからリソースへのアクセスを取り消す

PS C:\> $Resource = Get-SCVMTemplate | where {$_.Name -eq "Template01"}
PS C:\> Revoke-SCResource -Resource $Resource -UserRoleName "ContosoSelfServiceUsers"

最初のコマンドは、Template01 という名前のテンプレート オブジェクトを取得し、$Resource変数にオブジェクトを格納します。

2 番目のコマンドは、contosoSelfServiceUsers ユーザー ロールのすべてのメンバーから、$Resource (Template01) に格納されているリソースへのアクセスを取り消します。

パラメーター

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