Get-SCUserRole

構文

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

-Name

-OnBehalfOfUser

-OnBehalfOfUserRole

-UserRoleProfile

-VMMServer

出力

UserRole

このコマンドレットは 、UserRole オブジェクトを返します。

関連リンク

• Grant-SCResource
• New-SCUserRole
• Remove-SCUserRole
• Revoke-SCResource
• Set-SCUserRole