Set-SCCustomProperty
カスタム プロパティのプロパティを変更します。
構文
Set-SCCustomProperty
[-VMMServer <ServerConnection>]
-CustomProperty <CustomProperty>
[-Name <String>]
[-Description <String>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>] Set-SCCustomProperty
[-VMMServer <ServerConnection>]
-CustomProperty <CustomProperty>
[-Name <String>]
[-Description <String>]
-AddMember <CustomPropertyObjectType[]>
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>] Set-SCCustomProperty
[-VMMServer <ServerConnection>]
-CustomProperty <CustomProperty>
[-Name <String>]
[-Description <String>]
-RemoveMember <CustomPropertyObjectType[]>
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>] 説明
Set-SCCustomProperty コマンドレットは、カスタム プロパティのプロパティを変更します。 変更できるプロパティは次のとおりです。
- カスタム プロパティの説明
- カスタム プロパティの名前
- カスタム プロパティにメンバーを追加する
- カスタム プロパティからメンバーを削除する
カスタム プロパティの作成については、「Get-Help New-SCCustomProperty -Detailed」と入力します。
例
例 1: カスタム プロパティにメンバーを追加する
PS C:\> $CustomProp = Get-SCCustomProperty -Name "Cost Center"
PS C:\> Set-SCCustomProperty -CustomProperty $CustomProp -AddMember "VMHost"最初のコマンドは、Cost Center という名前のカスタム プロパティ オブジェクトを取得し、そのオブジェクトを $CustomProp 変数に格納します。
2 番目のコマンドは、$CustomPropに格納されているカスタム プロパティに VMHost メンバーを追加します。
例 2: カスタム プロパティからメンバーを削除する
PS C:\> $CustomProp = Get-SCCustomProperty -Name "Cost Center"
PS C:\> Set-SCCustomProperty -CustomProperty $CustomProp -RemoveMember "VM"最初のコマンドは、Cost Center という名前のカスタム プロパティ オブジェクトを取得し、そのオブジェクトを $CustomProp 変数に格納します。
2 番目のコマンドは、$CustomPropに格納されているカスタム プロパティ オブジェクトから VM メンバーを削除します。
パラメーター
-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 |
-CustomProperty
カスタム プロパティ オブジェクトを指定します。
| 型: | CustomProperty |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-Description
指定したオブジェクトの説明を指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-JobVariable
ジョブの進行状況を追跡し、このパラメーターによって指定された変数に格納することを指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Name
VMM オブジェクトの名前を指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-PROTipID
このアクションをトリガーしたパフォーマンスとリソースの最適化のヒント (PRO ヒント) の ID を指定します。 このパラメーターを使用すると、PRO のヒントを監査できます。
| 型: | Guid |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-RemoveMember
グループなどのメンバーシップの概念を持つ VMM オブジェクトからこのコマンドレットが削除するメンバーの配列を指定します。 たとえば、このコマンドレットは、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 |
-RunAsynchronously
コントロールがコマンド シェルにすぐに戻るように、ジョブが非同期的に実行されることを示します。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-VMMServer
VMM サーバー オブジェクトを指定します。
| 型: | ServerConnection |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |