New-SCCustomProperty
VMM データベースにカスタム プロパティ定義を作成します。
構文
New-SCCustomProperty
[-Name] <String>
[-Description <String>]
-AddMember <CustomPropertyObjectType[]>
[-VMMServer <ServerConnection>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>]
説明
New-SCCustomProperty コマンドレットは、Virtual Machine Manager (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
- User@Domain
- Domain\LabGroupAlias
- LabGroupAlias
ラボ グループのエイリアスは、電子メール エイリアスではなく、Active Directory Domain Servicesセキュリティ グループです。
Type: | CustomPropertyObjectType[] |
Accepted values: | VM, Template, VMHost, HostCluster, VMHostGroup, ServiceTemplate, ServiceInstance, ComputerTier, Cloud, ProtectionUnit |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Description
カスタム プロパティ定義の説明を指定します。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-JobVariable
ジョブの進行状況を追跡して、このパラメーターで示す名前の変数に保管するように指定します。
Type: | String |
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: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PROTipID
このアクションをトリガーしたパフォーマンスとリソースの最適化のヒント (PRO ヒント) の ID を指定します。 このパラメーターを使用すると、PRO のヒントを監査できます。
Type: | Guid |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RunAsynchronously
コントロールがコマンド シェルにすぐに戻るように、ジョブが非同期的に実行されることを示します。
Type: | SwitchParameter |
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 |