Get-SCCapabilityProfile
機能プロファイルを取得します。
構文
Get-SCCapabilityProfile
[-Name <String>]
[-VMMServer <ServerConnection>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
Get-SCCapabilityProfile
-ID <Guid>
[-VMMServer <ServerConnection>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
説明
Get-SCCapabilityProfile コマンドレットは、Virtual Machine Manager (VMM) で 1 つ以上の機能プロファイル オブジェクトを取得します。
例
例 1: 機能プロファイルを名前で取得する
PS C:\> Get-SCCapabilityProfile -Name "CapabilityProf01"
このコマンドは、CapabilityProf01 という名前の機能プロファイル オブジェクトを取得し、オブジェクトに関する情報をユーザーに表示します。
例 2: パラメーターの代理を使用して機能プロファイルを取得する
PS C:\> $UR = Get-SCUserRole -Name "UR01"
PS C:\> Get-SCCapabilityProfile -Name "CapabilityProf01" -OnBehalfOfUserRole $UR -OnBehalfOfUser "user01@contoso.com"
最初のコマンドは UR01 という名前のユーザー ロール オブジェクトを取得し、そのオブジェクトを $UR 変数に格納します。
2 番目のコマンドは、$URに格納されているユーザー ロールと、user01@contoso.comという名前のユーザーの代わりにフィルター処理された CapabilityProf01 という名前の機能プロファイル オブジェクトを取得します。 その後、コマンドレットはオブジェクトに関する情報をユーザーに表示します。
パラメーター
-ID
特定のオブジェクトのグローバル一意識別子 (GUID) として数値識別子を指定します。
型: | Guid |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Name
VMM オブジェクトの名前を指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-OnBehalfOfUser
ユーザー名を指定します。 このコマンドレットは、このパラメーターが指定したユーザーに代わって動作します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-OnBehalfOfUserRole
ユーザー ロールを指定します。 ユーザー ロールを取得するには、Get-SCUserRole コマンドレットを使用します。 このコマンドレットは、このパラメーターが指定するユーザー ロールに代わって動作します。
型: | UserRole |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-VMMServer
VMM サーバー オブジェクトを指定します。
型: | ServerConnection |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
出力
CloudCapabilityProfile
このコマンドレットは、CloudCapabilityProfile オブジェクトを返します。