PowerShell Logo Small

New-VirtualDiskSnapshot



This is the built-in help made by Microsoft for the command 'New-VirtualDiskSnapshot', in PowerShell version 3 - as retrieved from Windows version 'Microsoft Windows Server 2012 Standard' PowerShell help files on 2016-06-23.

For PowerShell version 3 and up, where you have Update-Help, this command was run just before creating the web pages from the help files.

SYNOPSIS

Creates a new snapshot of the specified virtual disk.

SYNTAX


New-VirtualDiskSnapshot [-AsJob [<SwitchParameter>]] [-CimSession <CimSession[]>] [-TargetStoragePoolName <String>] [-ThrottleLimit <Int32>]
-FriendlyName <String> -VirtualDiskUniqueId <String[]> [<CommonParameters>]
New-VirtualDiskSnapshot [-AsJob [<SwitchParameter>]] [-CimSession <CimSession[]>] [-TargetStoragePoolName <String>] [-ThrottleLimit <Int32>]
-FriendlyName <String> -InputObject <CimInstance[]> [<CommonParameters>]
New-VirtualDiskSnapshot [-AsJob [<SwitchParameter>]] [-CimSession <CimSession[]>] [-TargetStoragePoolName <String>] [-ThrottleLimit <Int32>]
-FriendlyName <String> -VirtualDiskName <String[]> [<CommonParameters>]
New-VirtualDiskSnapshot [-VirtualDiskFriendlyName] <String[]> [-AsJob [<SwitchParameter>]] [-CimSession <CimSession[]>]
[-TargetStoragePoolName <String>] [-ThrottleLimit <Int32>] -FriendlyName <String> [<CommonParameters>]



Search powershellhelp.space

DESCRIPTION


The New-VirtualDiskSnapshot cmdlet creates a new snapshot of the specified virtual disk.


This cmdlet is not needed when using the Storage Spaces subsystem.



<

RELATED LINKS

Get-VirtualDisk

REMARKS

<

Examples


EXAMPLE 1

PS C:\> New-VirtualDiskSnapshot -VirtualDiskFriendlyName "SQLData5" -TargetStoragePoolName "Snapshots"



This example creates a snapshot of the Virtual Disk object. The cmdlet returns the resultant snapshot as a new Virtual Disk object.