NAME
Get-DcsSnapshot
SYNOPSIS
Returns snapshot data for virtual disks.
SYNTAX
Get-DcsSnapshot [ -Server <Object> ] [ -VirtualDisk <Object> ] [ -Snapshot <Object> ] [ -SnapshotGroup <Object> ] [ -Connection <String> ] [ -PipelineVariable <String> ] [<CommonParameters>]
DESCRIPTION
Returns snapshot data for virtual disks. Filtering parameters may be specified to narrow the scope of the data returned. If no parameters are specified, all snapshots on all servers in the default connection will be returned.
PARAMETERS
- -Server<Object>
- Computer name or ID of the server. The computer name must be unique or the name must be fully qualified. If specified, only data for the designated server will be returned.
-
- Required: false
- Position: named
- Default value:
- Accept pipeline input: false
- Accept wildcard characters: false
-
- -VirtualDisk<Object>
- VirtualDiskData object, name, or ID that identifies a virtual disk. If specified, only snapshot data for the designated virtual disk will be returned.
-
- Required: false
- Position: named
- Default value:
- Accept pipeline input: true (ByValue)
- Accept wildcard characters: false
-
- -Snapshot<Object>
- SnapshotData object, name or ID of a snapshot. If specified, only data for that snapshot will be returned.
-
- Required: false
- Position: named
- Default value:
- Accept pipeline input: false
- Accept wildcard characters: false
-
- -SnapshotGroup<Object>
- SnapshotGroupData object, name or ID that identifies a snapshot group. If specified, only snapshot data for that snapshot group will be returned.
-
- Required: false
- Position: named
- Default value:
- Accept pipeline input: false
- Accept wildcard characters: false
-
- -Connection<String>
- Alias of the connection to the server group. If not specified, the default connection will be used.
-
- Required: false
- Position: named
- Default value:
- Accept pipeline input: false
- Accept wildcard characters: false
-
- -PipelineVariable<String>
-
- Required: false
- Position: named
- Default value:
- Accept pipeline input: false
- Accept wildcard characters: false
- <CommonParameters>
- This cmdlet supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, pipelineVariable, and OutVariable. For more information, see about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).
-
INPUTS
VirtualDiskData : Object that identifies and describes the virtual disk.
OUTPUTS
SnapshotData : Object that identifies and describes the snapshot.
NOTES
Also see Get-DcsSnapshotMapStore, Add-DcsSnapshot, Remove-DcsSnapshot.
EXAMPLES
-------------- Example 1 Returns data for all snapshots on a specific server by piping objects --------------
Get-DcsVirtualDisk -Server SSV1 | Get-DcsSnapshot
The cmdlet Get-DcsSnapshot is invoked without parameters resulting in the return of data for all snapshots in the server group.
| SourceLogicalDiskId | : | LD:A6EA4E77-BBFF-4F48-91CD-3987E81C1CB3_V.{ea7c7a80-bdf3-11e0-8304-00155d11e921}-00000018 |
| DestinationLogicalDiskId | : | LD:A6EA4E77-BBFF-4F48-91CD-3987E81C1CB3_V.{ea7c7a80-bdf3-11e0-8304-00155d11e921}-00000023 |
| Type | : | Differential |
| TimeStamp | : | 8/12/2011 9:47:02 AM |
| ActiveOperation | : | NoOperation |
| State | : | Healthy |
| Failure | : | NoFailure |
| CompressionEnabled | : | False |
| Sequencenumber | : | 8180 |
| Id | : | V.{EA7C7A80-BDF3-11E0-8304-00155D11E921}-00000018--V.{EA7C7A80-BDF3-11E0-8304-00155D11E921}-00000023 |
| Caption | : | Virtual disk 1 @ 8/12/2011 9:46:09 AM |
| ExtendedCaption | : | Virtual disk 1 @ 8/12/2011 9:46:09 AM on SSV1 |
| Internal | : | False |
| SourceLogicalDiskId | : | LD:A6EA4E77-BBFF-4F48-91CD-3987E81C1CB3_V.{ea7c7a80-bdf3-11e0-8304-00155d11e921}-00000019 |
| DestinationLogicalDiskId | : | LD:A6EA4E77-BBFF-4F48-91CD-3987E81C1CB3_V.{ea7c7a80-bdf3-11e0-8304-00155d11e921}-00000025 |
| Type | : | Full |
| TimeStamp | : | 8/12/2011 9:47:04 AM |
| ActiveOperation | : | NoOperation |
| State | : | Migrated |
| Failure | : | NoFailure |
| CompressionEnabled | : | True |
| Sequencenumber | : | 5193 |
| Id | : | V.{EA7C7A80-BDF3-11E0-8304-00155D11E921}-00000019--V.{EA7C7A80-BDF3-11E0-8304-00155D11E921}-00000025 |
| Caption | : | Virtual disk 2 @ 8/12/2011 9:46:25 AM |
| ExtendedCaption | : | Virtual disk 2 @ 8/12/2011 9:46:25 AM on SSV1 |
| Internal | : | False |
-------------- Example 2 Returns data for a virtual disk specified by name --------------
Get-DcsSnapshot -VirtualDisk "Virtual disk 2"
Returns data for all snapshots created from "Virtual disk 2". There are two snapshots.
| SourceLogicalDiskId | : | LD:84972D6B-7E71-4616-BDA1-57ECEAF3FFC4_V.{ea7c7a80-bdf3-11e0-8304-00155d11e921}-0000002E |
| DestinationLogicalDiskId | : | LD:84972D6B-7E71-4616-BDA1-57ECEAF3FFC4_V.{ea7c7a80-bdf3-11e0-8304-00155d11e921}-00000038 |
| Type | : | Differential |
| TimeStamp | : | 8/16/2011 1:06:06 PM |
| ActiveOperation | : | NoOperation |
| State | : | Healthy |
| Failure | : | NoFailure |
| CompressionEnabled | : | False |
| Sequencenumber | : | 5189 |
| Id | : | V.{EA7C7A80-BDF3-11E0-8304-00155D11E921}-0000002E--V.{EA7C7A80-BDF3-11E0-8304-00155D11E921}-00000038 |
| Caption | : | Virtual disk 2 @ 8/16/2011 1:06:00 PM |
| ExtendedCaption | : | Virtual disk 2 @ 8/16/2011 1:06:00 PM on SSV1 |
| Internal | : | False |
| SourceLogicalDiskId | : | LD:84972D6B-7E71-4616-BDA1-57ECEAF3FFC4_V.{ea7c7a80-bdf3-11e0-8304-00155d11e921}-0000002E |
| DestinationLogicalDiskId | : | LD:84972D6B-7E71-4616-BDA1-57ECEAF3FFC4_V.{ea7c7a80-bdf3-11e0-8304-00155d11e921}-00000037 |
| Type | : | Full |
| TimeStamp | : | 8/16/2011 1:05:18 PM |
| ActiveOperation | : | NoOperation |
| State | : | Migrated |
| Failure | : | NoFailure |
| CompressionEnabled | : | False |
| Sequencenumber | : | 5181 |
| Id | : | V.{EA7C7A80-BDF3-11E0-8304-00155D11E921}-0000002E--V.{EA7C7A80-BDF3-11E0-8304-00155D11E921}-00000037 |
| Caption | : | Virtual disk 2 @ 8/16/2011 1:05:03 PM |
| ExtendedCaption | : | Virtual disk 2 @ 8/16/2011 1:05:03 PM on SSV1 |
| Internal | : | False |