次の方法で共有

Get-SCUserRole

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

VMM ユーザー ロールを取得します。

構文

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
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Name

このコマンドレットが取得する VMM ユーザー ロールの名前を指定します。

型:String
配置:0
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-OnBehalfOfUser

ユーザー名を指定します。 このコマンドレットは、このパラメーターが指定したユーザーに代わって動作します。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-OnBehalfOfUserRole

ユーザー ロールを指定します。 ユーザー ロールを取得するには、Get-SCUserRole コマンドレットを使用します。 このコマンドレットは、このパラメーターが指定するユーザー ロールに代わって動作します。

型:UserRole
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-UserRoleProfile

このコマンドレットが取得するユーザー ロールの基礎となるプロファイルの種類を指定します。 このパラメーターに使用できる値は次のとおりです。

  • DelegatedAdmin
  • ReadOnlyAdmin
  • SelfServiceUser
型:Profile
指定可能な値:Administrator, DelegatedAdmin, TenantAdmin, SelfServiceUser, ReadOnlyAdmin
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-VMMServer

このコマンドレットがユーザー ロールを取得する VMM サーバーを指定します。

型:ServerConnection
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

出力

UserRole

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