Update-SCVMConfiguration
VMM 仮想マシン構成オブジェクトのプロパティを更新します。
構文
Update-SCVMConfiguration
[-VMConfiguration] <BaseVMConfiguration>
[-ValidateOnly <Boolean>]
[-VMName <String>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
Update-SCVMConfiguration
-VMConfigurationList <System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.BaseVMConfiguration]>
[-ValidateOnly <Boolean>]
[-VMName <String>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
説明
Update-SCVMConfiguration コマンドレットは、仮想マシン マネージャー (VMM) 仮想マシン構成オブジェクトのプロパティを更新します。
例
例 1: 既存の仮想マシン構成を更新する
PS C:\> $ServiceConfig = Get-SCServiceConfiguration -Name "Service01"
PS C:\> $VMConfig = Get-SCVMConfiguration -ServiceConfiguration $ServiceConfig
PS C:\> Update-SCVMConfiguration -VMConfiguration $VMConfig[0] -ValidateOnly $True
最初のコマンドは、VMM ライブラリから Service01 という名前のサービス構成オブジェクトを取得し、そのオブジェクトを $ServiceConfig 変数に格納します。
2 番目のコマンドは、$ServiceConfigに格納されているサービス構成の仮想マシン構成オブジェクトを取得し、仮想マシン構成オブジェクトを$VMConfigに格納します。
最後のコマンドは、$VMConfigに格納されている最初の構成オブジェクトの ValidateOnly プロパティを True に設定します。
パラメーター
-JobVariable
ジョブの進行状況を追跡し、このパラメーターによって指定された変数に格納することを指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-OnBehalfOfUser
ユーザーの名前を指定します。 このコマンドレットは、このパラメーターが指定するユーザーとしてユーザーの代理を設定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-OnBehalfOfUserRole
ユーザー ロールを指定します。 このコマンドレットは、このパラメーターが指定するユーザー ロールとしてユーザー ロールの代理を設定します。 ユーザー ロール オブジェクトを取得するには、Get-SCUserRole コマンドレットを使用します。
型: | UserRole |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-PROTipID
このアクションをトリガーしたパフォーマンスとリソースの最適化のヒント (PRO ヒント) の ID を指定します。 このパラメーターを使用すると、PRO のヒントを監査できます。
型: | Guid |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-RunAsynchronously
コントロールがコマンド シェルにすぐに戻るように、ジョブが非同期的に実行されることを示します。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-ValidateOnly
配置の検証が実行されるが、配置が実際には実行されないかどうかを示します。
型: | Boolean |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-VMConfiguration
仮想マシン構成オブジェクトを指定します。
型: | BaseVMConfiguration |
配置: | 0 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-VMConfigurationList
構成オブジェクトの一覧を指定します。
型: | System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.BaseVMConfiguration] |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-VMName
物理ホスト サーバーに配置する仮想マシンの名前を指定します。 このパラメーターを使用して、同じ名前の別の仮想マシンがまだそのホストにデプロイされていないことを確認します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
出力
ComputerConfig
このコマンドレットは、ComputerConfig オブジェクトを返します。
メモ
- Get-SCVMConfiguration コマンドレットを使用して取得できる VMM 仮想マシン構成オブジェクトが必要です。