次の方法で共有

New-SCCustomProperty

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

VMM データベースにカスタム プロパティ定義を作成します。

構文

New-SCCustomProperty
   [-Name] <String>
   [-Description <String>]
   -AddMember <CustomPropertyObjectType[]>
   [-VMMServer <ServerConnection>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

説明

New-SCCustomProperty コマンドレットは、仮想マシン マネージャー (VMM) データベースにカスタム プロパティ定義を作成します。

次のオブジェクト型のカスタム プロパティを作成できます。

  • VM
  • テンプレート
  • VMHost
  • HostCluster
  • VMHostGroup
  • ServiceTemplate
  • ServiceInstance
  • ComputerTier
  • 雲

例

例 1: カスタム プロパティを作成する

PS C:\> $CustomProp = New-SCCustomProperty -Name "Cost Center" -AddMember "VM"
PS C:\> $CustomProp

最初のコマンドは、VM をメンバーとして使用して Cost Center という名前のカスタム プロパティ オブジェクトを作成し、そのオブジェクトを $CustomProp 変数に格納します。

2 番目のコマンドは、ユーザーに$CustomPropに格納されているカスタム プロパティ オブジェクトのプロパティを表示します。

パラメーター

-AddMember

このコマンドレットがグループなどのメンバーの概念を持つオブジェクトに追加するメンバーの配列を指定します。 たとえば、このコマンドレットでは、1 つ以上の Active Directory® Domain Services ドメイン ユーザーまたはグループをユーザー ロールに追加できます。 次の形式でメンバーを指定します。

  • Domain\User
  • 利用者
  • User@Domain
  • Domain\LabGroupAlias
  • LabGroupAlias

ラボ グループのエイリアスは、電子メール エイリアスではなく、Active Directory Domain Services セキュリティ グループです。

型:CustomPropertyObjectType[]
指定可能な値:VM, Template, VMHost, HostCluster, VMHostGroup, ServiceTemplate, ServiceInstance, ComputerTier, Cloud, ProtectionUnit
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Description

カスタム プロパティ定義の説明を指定します。

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

-JobVariable

ジョブの進行状況を追跡し、このパラメーターによって指定された変数に格納することを指定します。

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

-Name

VMM オブジェクトの名前を指定します。

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

-PROTipID

このアクションをトリガーしたパフォーマンスとリソースの最適化のヒント (PRO ヒント) の ID を指定します。 このパラメーターを使用すると、PRO のヒントを監査できます。

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

-RunAsynchronously

コントロールがコマンド シェルにすぐに戻るように、ジョブが非同期的に実行されることを示します。

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

-VMMServer

VMM サーバー オブジェクトを指定します。

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