Set-SCVMCheckpoint
VMM のバーチャル マシン チェックポイント オブジェクトのプロパティを変更します。
構文
Default (既定)
Set-SCVMCheckpoint
-VMCheckpoint <VMCheckpoint>
[-Description <String>]
[-Name <String>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
説明
Set-SCVMCheckpoint コマンドレットは、Virtual Machine Manager (VMM) の仮想マシン チェックポイント オブジェクトのプロパティを変更します。
VMM チェックポイントの作成については、「 Get-Help New-SCVMCheckpoint -Detailed」と入力してください。
例
例 1: すべてのチェックポイントの説明を指定した文字列に設定する
PS C:\> Get-SCVMCheckpoint | Set-SCVMCheckpoint -Description "All checkpoints created prior to upgrade"
このコマンドは、VMM データベースから既存のすべてのチェックポイント・オブジェクトを取得し、これらのチェックポイントの説明を更新します。
例 2: すべてのチェックポイントの名前と説明を変更する
PS C:\> Get-SCVMCheckpoint | Set-SCVMCheckpoint -Name "Checkpoint Before Upgrade" -Description "Checkpoint was created prior to upgrade"
このコマンドは、既存のチェックポイント・オブジェクトをすべて取得し、各オブジェクトの名前と説明を変更します。
例 3: チェックポイントの配列内の特定のチェックポイントを変更する
PS C:\> $VM = Get-SCVirtualMachine -Name "VM03"
PS C:\> Set-SCVMCheckpoint -VMCheckpoint $VM.VMCheckpoints[0] -Description "First Checkpoint Before Upgrade"
最初のコマンドは、VM03 という名前の仮想マシン オブジェクトを取得し、そのオブジェクトを $VM 変数に格納します。
最後のコマンドは、VM03 の VMCheckpoints 配列内の最初のチェックポイント オブジェクトの説明を変更します。
パラメーター
-Description
チェックポイントの説明を指定します。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-JobVariable
ジョブの進行状況を追跡され、このパラメーターで指定された変数に格納するように指定します。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Name
VMM オブジェクトの名前を指定します。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-OnBehalfOfUser
ユーザーの名前を指定します。 このコマンドレットは、このパラメーターが指定するユーザーとしてユーザーの代理を設定します。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-OnBehalfOfUserRole
ユーザー ロールを指定します。 このコマンドレットは、このパラメーターが指定するユーザー ロールとしてユーザー ロールの代理を設定します。 ユーザー ロール オブジェクトを取得するには、Get-SCUserRole コマンドレットを使用します。
パラメーターのプロパティ
| 型: | UserRole |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-PROTipID
このアクションをトリガーしたパフォーマンスとリソースの最適化のヒント (PRO ヒント) の ID を指定します。 このパラメーターを使用すると、PRO のヒントを監査できます。
パラメーターのプロパティ
| 型: | Guid |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-RunAsynchronously
コントロールがコマンド シェルにすぐに戻るように、ジョブが非同期的に実行されることを示します。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-VMCheckpoint
VMM 仮想マシンのチェックポイント オブジェクトを指定します。
パラメーターのプロパティ
| 型: | VMCheckpoint |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。
出力
VMCheckpoint
このコマンドレットは、 VMCheckpoint オブジェクトを返します。
メモ
- VMM チェックポイント オブジェクトが必要であり、 Get-SCVMCheckpoint コマンドレットを使用して取得できます。