Revoke-SCResource
ユーザーまたはユーザー ロールからリソースへのアクセスを取り消します。
構文
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 オブジェクトを返します。