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 番目のコマンドは、Katarina という名前のユーザーから $Resource (Template01) に格納されているリソースへのアクセスを取り消します。ただし、ユーザーが ContosoSelfServiceUsers または SelfServiceUserRole02 ユーザー ロールを使用している場合に限ります。 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
同じジョブ グループ識別子を含む最後のコマンドが実行される直前にセットとして実行される一連のコマンドの識別子を指定します。
| 型: | 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 オブジェクトを返します。