SnapCenter Windows disk management cmdlets
New-SdSnapshot
Suggest changes
PDFs
Creates Snapshot copies of specified Windows disks or SMB shares.
Syntax
New-SdSnapshot [-Path] <Object[]> [-Snapshot] <String> [-NoCleanUpOnError] <> [-UpdateMirror] <> [-CrashConsistent] <> [-Session] <String> [-Host] <String>
Detailed Description
Creates Snapshot copies of specified Windows disks or SMB shares.Related cmdlets: Get-SdSnapshot, Remove-SdSnapshot and Rename-SdSnapshot
Parameters
| Name | Description | Required? | Pipeline Input | Default Value |
|---|---|---|---|---|
Path |
Provides the volume, logical disk, or a comma-separated list of SMB shares of which you want to make Snapshot copies. You cannot mix a logical disk or mount point with SMB shares in the same input path. |
true |
true (ByValue, ByPropertyName) |
|
Snapshot |
Designates the name of the new Snapshot copy. You cannot use special characters in a Snapshot copy name. If you do not specify a Snapshot copy name, a GUID appended with timestamp is generated and used as the Snapshot copy name. |
false |
true (ByPropertyName) |
A GUID appended with timestamp will be generated and used for the Snapshot copy name |
NoCleanUpOnError |
Indicates whether you want to delete Snapshot copies if there is an error in backing up one of the specified resources, that results in an incomplete Snapshot backup. |
false |
true (ByPropertyName) |
|
UpdateMirror |
Initiates a mirror or vault update after your Snapshot operation completes. |
false |
false |
|
CrashConsistent |
false |
false |
||
Session |
false |
true (ByPropertyName) |
||
Host |
Specifies the name or IP address of the host on which you execute the operation. The default is your local machine. |
false |
true (ByPropertyName) |
Examples
Example 1: Backing up the specified SMB shares
PS C:\> New-SdSnapshot -Path "\\fileserver\sqlshare","\\fileserver\sqlshare2" -Snapshot "sql_snap"
This example syntax backs up the SMB shares by creating Snapshot copies of the corresponding volumes using Snapshot name sql_snap.
Example 2: Backing up the specified disk
PS C:\> New-SdSnapshot -Path E: -Snapshot "sql_snap"
This example syntax backs up the disk drive by creating Snapshot copies of the corresponding volumes using Snapshot name sql_snap.