次の方法で共有

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 を指定します。

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

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

Type:String
Position:0
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

-UserRoleProfile

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

  • DelegatedAdmin
  • ReadOnlyAdmin
  • SelfServiceUser
Type:Profile
Accepted values:Administrator, DelegatedAdmin, TenantAdmin, SelfServiceUser, ReadOnlyAdmin
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:True
Accept wildcard characters:False

出力

UserRole

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