Get-SCCustomPropertyValue

カスタム プロパティ値オブジェクトを取得します。

構文

Get-SCCustomPropertyValue
   [-VMMServer <ServerConnection>]
   [-All]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Get-SCCustomPropertyValue
   [-VMMServer <ServerConnection>]
   -CustomProperty <CustomProperty>
   -InputObject <ClientObject>
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

説明

Get-SCCustomPropertyValue コマンドレットは、カスタム プロパティ値オブジェクトを取得します。

例 1: 仮想マシンのカスタム プロパティの値を取得する

PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> $CustomProp = Get-SCCustomProperty -Name "Cost Center"
PS C:\> Get-SCCustomPropertyValue -InputObject $VM -CustomProperty $CustomProp

最初のコマンドは、VM01 という名前の仮想マシン オブジェクトを取得し、そのオブジェクトを $VM 変数に格納します。

2 番目のコマンドは、Cost Center という名前のカスタム プロパティ オブジェクトを取得し、$CustomProp変数にオブジェクトを格納します。

最後のコマンドは、$VM (VM01) に格納されている仮想マシンの $CustomProp (Cost Center) に格納されているカスタム プロパティの値を取得します。

パラメーター

-All

このコマンドレットは、親オブジェクトに依存しないすべての下位オブジェクトを取得することを示します。 たとえば、コマンド Get-SCVirtualDiskDrive -All は、各仮想ディスク ドライブ オブジェクトが関連付けられている仮想マシン オブジェクトまたはテンプレート オブジェクトに関係なく、すべての仮想ディスク ドライブ オブジェクトを取得します。

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

-CustomProperty

カスタム プロパティ オブジェクトを指定します。

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

-InputObject

取得または変更する値を持つプロパティを割り当てるオブジェクトを指定します。

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