Get-SCUserRole
VMM ユーザー ロールを取得します。
構文
Default (既定)
Get-SCUserRole
[-VMMServer <ServerConnection>]
[[-Name] <String>]
[-UserRoleProfile <Profile>]
[-ID <Guid>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
説明
Get-SCUserRole コマンドレットは、1 つ以上の Virtual Machine Manager (VMM) ユーザー ロールを取得します。 VMM では、ロールベースのセキュリティを使用して、特定のユーザー ロールのメンバーが操作できる境界と、ユーザー ロールのメンバーが実行できる一連の許可された操作を定義します。
ユーザー・ロールの作成については、「 Get-Help New-SCUserRole」と入力してください。
委任管理者と読み取り専用管理者のスコープ、セルフサービス ユーザーのスコープとアクションなど、ユーザー ロールのプロパティの設定については、「 Get-Help Set-SCUserRole」と入力してください。
例
例 1: すべてのユーザー ロールを取得する
PS C:\> Get-SCUserRole -VMMServer "VMMServer01.Contoso.com"
このコマンドは、VMMServer01.Contoso.com という名前のサーバー上のすべての VMM ユーザー ロールを取得します。 このコマンドは、各ユーザー・ロールに関する情報を表示します。
例 2: 名前でユーザー ロールを取得する
PS C:\> Get-SCUserRole -Name "Administrator"
このコマンドは、Administrator という名前のユーザー・ロール・オブジェクトを取得します。 このコマンドは、そのユーザー・ロールに関する情報を表示します。
例 3: プロファイルごとにユーザー役割を取得する
PS C:\> Get-SCUserRole -VMMServer "VMMServer01.Contoso.com" -UserRoleProfile "SelfServiceUser"
このコマンドは、ユーザー・ロール・プロファイルが SelfServiceUser である VMMServer01 という名前のサーバーのユーザー・ロールを取得します。 このコマンドは、これらのユーザー・ロールに関する情報を表示します。
例 4: ユーザー・ロール・オブジェクトに関するプロパティーおよびその他の情報を表示する
PS C:\> $UserRoles = Get-SCUserRole -VMMServer "VMMServer01.Contoso.com"
PS C:\> $UserRoles | Select-Object -Property Name, UserRoleProfile, ParentUserRole, Cloud
PS C:\> $UserRoles | Get-Member
最初のコマンドは、VMMServer01 という名前のサーバー上のすべてのユーザー ロール オブジェクトを取得し、それらのオブジェクトを $UserRoles 変数に格納します。
2 番目のコマンドは、$UserRoles 内の各ユーザー ロール オブジェクトを Select-Object コマンドレットに渡し、各ユーザー ロールの名前、ユーザー ロール プロファイル、親ユーザー ロール、およびクラウドを表示します
最後のコマンドは、$UserRoles の各ユーザー ロールを Get-Member コマンドレットに渡し、各ユーザー ロールの .NET 型と、各ユーザー ロールの種類に関連付けられているメソッドとプロパティを表示します。
パラメーター
-ID
このコマンドレットが取得するユーザー ロールの一意の ID を指定します。
パラメーターのプロパティ
| 型: | Guid |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Name
このコマンドレットが取得する VMM ユーザー ロールの名前を指定します。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 0 |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-OnBehalfOfUser
ユーザー名を指定します。 このコマンドレットは、このパラメーターで指定されているユーザーに代わって動作します。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-OnBehalfOfUserRole
ユーザー ロールを指定します。 ユーザー ロールを取得するには、 Get-SCUserRole コマンドレットを使用します。 このコマンドレットは、このパラメーターで指定されているユーザー ロールに代わって動作します。
パラメーターのプロパティ
| 型: | UserRole |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-UserRoleProfile
このコマンドレットが取得するユーザー ロールの基礎となるプロファイルの種類を指定します。 このパラメーターに使用できる値は次のとおりです。
- 委任管理者
- ReadOnly管理者
- セルフサービスユーザー
パラメーターのプロパティ
| 型: | Profile |
| 規定値: | None |
| 指定可能な値: | Administrator, DelegatedAdmin, TenantAdmin, SelfServiceUser, ReadOnlyAdmin |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-VMMServer
このコマンドレットがユーザー ロールを取得する VMM サーバーを指定します。
パラメーターのプロパティ
| 型: | ServerConnection |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。
出力
UserRole
このコマンドレットは UserRole オブジェクトを返します。