Export-VMSnapshot

[アーティクル]
11/16/2015

Export-VMSnapshot

Exports a virtual machine checkpoint to disk.

構文

Parameter Set: SnapshotName
Export-VMSnapshot [-Name] <String[]> [-Path] <String> -VMName <String[]> [-AsJob] [-CimSession <Microsoft.Management.Infrastructure.CimSession[]> ] [-ComputerName <String[]> ] [-Credential <System.Management.Automation.PSCredential[]> ] [-Passthru] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: SnapshotObject
Export-VMSnapshot [-VMSnapshot] <VMSnapshot[]> [-Path] <String> [-AsJob] [-Passthru] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: VMObject
Export-VMSnapshot [-VM] <VirtualMachine[]> [-Path] <String> -Name <String[]> [-AsJob] [-Passthru] [-Confirm] [-WhatIf] [ <CommonParameters>]

詳細説明

The Export-VMSnapshot cmdlet exports a virtual machine checkpoint to disk.

Note: In Windows Server 2012 R2, virtual machine snapshots were renamed to virtual machine checkpoints. For clarity, this document will refer to virtual machine snapshots as checkpoints.

パラメーター

-AsJob

Runs the cmdlet as a background job.

Aliases	none
必須/オプション	false
位置	named
既定値	none
パイプライン入力の受け入れ	false
ワイルドカード文字の受け入れ	false

-CimSession<Microsoft.Management.Infrastructure.CimSession[]>

リモートセッションまたはリモートコンピューターでコマンドレットを実行します。コンピューター名またはセッションオブジェクト (New-CimSession コマンドレットや Get-CimSession コマンドレットの出力など) を入力します。既定値は、ローカルコンピューター上の現在のセッションです。

Aliases	none
必須/オプション	false
位置	named
既定値	none
パイプライン入力の受け入れ	false
ワイルドカード文字の受け入れ	false

-ComputerName<String[]>

Specifies one or more Hyper-V hosts on which the virtual machine checkpoint is to be exported. NetBIOS names, IP addresses, and fully qualified domain names are allowable. The default is the local computer. Use localhost or a dot (.) to specify the local computer explicitly.

Aliases	none
必須/オプション	false
位置	named
既定値	none
パイプライン入力の受け入れ	false
ワイルドカード文字の受け入れ	false

-Credential<System.Management.Automation.PSCredential[]>

Specifies one or more user accounts that have permission to perform this action. The default is the current user.

Aliases	none
必須/オプション	false
位置	named
既定値	none
パイプライン入力の受け入れ	false
ワイルドカード文字の受け入れ	false

-Name<String[]>

Specifies the name of the checkpoint to be exported.

Aliases	none
必須/オプション	true
位置	named
既定値	none
パイプライン入力の受け入れ	false
ワイルドカード文字の受け入れ	false

-Passthru

Specifies that a VMSnapshot object is to be passed through to the pipeline representing the checkpoint to be exported.

Aliases	none
必須/オプション	false
位置	named
既定値	none
パイプライン入力の受け入れ	false
ワイルドカード文字の受け入れ	false

-Path<String>

Specifies the path to the folder into which the checkpoint is to be exported.

Aliases	none
必須/オプション	true
位置	2
既定値	none
パイプライン入力の受け入れ	false
ワイルドカード文字の受け入れ	false

-VM<VirtualMachine[]>

Specifies the virtual machine of which the checkpoint is to be exported.

Aliases	none
必須/オプション	true
位置	1
既定値	none
パイプライン入力の受け入れ	True (ByValue)
ワイルドカード文字の受け入れ	false

-VMName<String[]>

Specifies the name of the virtual machine of which the checkpoint is to be exported.

Aliases	none
必須/オプション	true
位置	named
既定値	none
パイプライン入力の受け入れ	false
ワイルドカード文字の受け入れ	false

-VMSnapshot<VMSnapshot[]>

Specifies the checkpoint to be exported.

Aliases	VMCheckpoint
必須/オプション	true
位置	1
既定値	none
パイプライン入力の受け入れ	True (ByValue)
ワイルドカード文字の受け入れ	false

-Confirm

コマンドレットを実行する前に確認メッセージを表示します。

必須/オプション	false
位置	named
既定値	false
パイプライン入力の受け入れ	false
ワイルドカード文字の受け入れ	false

-WhatIf

コマンドレットが実行された場合に何が起きるのかを示します。コマンドレットは実行されません。

必須/オプション	false
位置	named
既定値	false
パイプライン入力の受け入れ	false
ワイルドカード文字の受け入れ	false

<CommonParameters>

このコマンドレットは共通のパラメーターをサポートしています(-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer、および -OutVariable)。詳細については、TechNet の「「about_CommonParameters」 (https://go.microsoft.com/fwlink/p/?LinkID=113216) を参照してください。

入力

入力型は、コマンドレットにパイプできるオブジェクトの型です。

出力

出力型は、コマンドレットが出力するオブジェクトの型です。

None by default; Microsoft.HyperV.PowerShell.Snapshot if –PassThru is specified.

使用例

Example 1

Exports checkpoint Base Image of virtual machine TestVM to D:\.

PS C:\> Export-VMSnapshot –Name 'Base Image' –VMName TestVM –Path D:\

Export-VMSnapshot