Remove-VMSnapshot

Remove-VMSnapshot

Deletes a virtual machine checkpoint.

Синтаксис

Parameter Set: SnapshotName
Remove-VMSnapshot [-VMName] <String[]> [[-Name] <String[]> ] [-AsJob] [-ComputerName <String[]> ] [-IncludeAllChildSnapshots] [-Passthru] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: SnapshotObject
Remove-VMSnapshot [-VMSnapshot] <VMSnapshot[]> [-AsJob] [-IncludeAllChildSnapshots] [-Passthru] [-Confirm] [-WhatIf] [ <CommonParameters>]

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

Подробное описание

The Remove-VMSnapshot deletes a virtual machine checkpoint.

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

Specifies that the cmdlet is to be run as a background job.

Псевдонимы	отсутствуют
Требуется?	false
Указать положение?	named
Значение по умолчанию	отсутствуют
Принимать входные данные конвейера?	false
Принимать подстановочные знаки?	false

-ComputerName<String[]>

Specifies one or more Hyper-V hosts on which a checkpoint is to be deleted. 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.

Псевдонимы	отсутствуют
Требуется?	false
Указать положение?	named
Значение по умолчанию	.
Принимать входные данные конвейера?	false
Принимать подстановочные знаки?	false

-IncludeAllChildSnapshots

Specifies that the checkpoint’s children are to be deleted along with the checkpoint.

Псевдонимы	отсутствуют
Требуется?	false
Указать положение?	named
Значение по умолчанию	отсутствуют
Принимать входные данные конвейера?	false
Принимать подстановочные знаки?	false

-Name<String[]>

Specifies the name of the checkpoint to be deleted.

Псевдонимы	отсутствуют
Требуется?	false
Указать положение?	2
Значение по умолчанию	отсутствуют
Принимать входные данные конвейера?	True (ByValue)
Принимать подстановочные знаки?	false

-Passthru

Specifies that an object is to be passed through to the pipeline representing the checkpoint to be deleted.

Псевдонимы	отсутствуют
Требуется?	false
Указать положение?	named
Значение по умолчанию	отсутствуют
Принимать входные данные конвейера?	false
Принимать подстановочные знаки?	false

-VM<VirtualMachine[]>

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

Псевдонимы	отсутствуют
Требуется?	true
Указать положение?	1
Значение по умолчанию	отсутствуют
Принимать входные данные конвейера?	True (ByValue)
Принимать подстановочные знаки?	false

-VMName<String[]>

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

Псевдонимы	отсутствуют
Требуется?	true
Указать положение?	1
Значение по умолчанию	отсутствуют
Принимать входные данные конвейера?	false
Принимать подстановочные знаки?	false

-VMSnapshot<VMSnapshot[]>

Specifies the checkpoint to be deleted.

Псевдонимы	отсутствуют
Требуется?	true
Указать положение?	1
Значение по умолчанию	отсутствуют
Принимать входные данные конвейера?	True (ByValue)
Принимать подстановочные знаки?	false

-Confirm

Запрос на подтверждение перед выполнением командлета.

Требуется?	false
Указать положение?	named
Значение по умолчанию	false
Принимать входные данные конвейера?	false
Принимать подстановочные знаки?	false

-WhatIf

Показывает, что произойдет при запуске командлета. Командлет не запущен.

Требуется?	false
Указать положение?	named
Значение по умолчанию	false
Принимать входные данные конвейера?	false
Принимать подстановочные знаки?	false

<CommonParameters>

Этот командлет поддерживает следующие параметры: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, и -OutVariable. Для получения дополнительных сведений см. about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Входные данные

Тип входных данных — это тип объектов, которые можно передать в командлет через конвейер.

Выходные данные

Тип выходных данных — это тип объектов, которые выдает командлет.

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

Примеры

Example 1

Deletes all checkpoints of virtual machine TestVM whose names starts with Experiment.

PS C:\> Get-VM TestVM | Remove-VMSnapshot –Name Experiment*

Example 2

Deletes all checkpoints of virtual machine TestVM older than 90 days.

PS C:\> Get-VMSnapshot -VMName TestVM | Where-Object {$_.CreationTime -lt (Get-Date).AddDays(-90) } | Remove-VMSnapshot