NAME
Add-DcsPassthroughSnapshot
SYNOPSIS
Creates a full snapshot with a destination that is a pass-through virtual disk.
SYNTAX
Add-DcsPassthroughSnapshot [ -Server <String> ] -VirtualDisk <Object> -Disk <Object> [ -Name <String> ] [ -Description <String> ] [ -Connection <String> ] [ -PipelineVariable <String> ]
DESCRIPTION
Creates a full snapshot with a destination that is a pass-through virtual disk. The purpose is to allow the migration of virtual disks with pool storage sources to physical disks.
PARAMETERS
- -Server<String>
- The computer name or ID that identifies the server where the snapshot should be created. The computer name must be unique or the name must be fully qualified.
-
- Required: false
- Position: named
- Default value:
- Accept pipeline input: false
- Accept wildcard characters: false
-
- -VirtualDisk<Object>
- VirtualDiskData object, name or ID that identifies the virtual disk to use as the source of the snapshot.
-
- Required: true
- Position: named
- Default value:
- Accept pipeline input: false
- Accept wildcard characters: false
-
- -Disk<Object>
- PhysicalDiskData object, name, or ID that identifies a physical disk to be used as the snapshot destination. The disk should be initialized, but not be partitioned.
-
- Required: true
- Position: named
- Default value:
- Accept pipeline input: true (ByValue)
- Accept wildcard characters: false
-
- -Name<String>
- Name to assign to the snapshot. If not specified a default name will be assigned. The default name will consist of "[PT}", a space, then the name of the source virtual disk and timestamp of when the snapshot is created. For instance: [PT] <Virtualdiskname><Timestamp>.
-
- Required: false
- Position: named
- Default value:
- Accept pipeline input: false
- Accept wildcard characters: false
-
- -Description<String>
- Description of the snapshot.
-
- 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 is 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
-
INPUTS
PhysicalDiskData : Object that identifies the disk.
OUTPUTS
SnapshotData : Object that identifies and describes the snapshot.
NOTES
Also see Get-DcsPhysicalDisk
EXAMPLES
Add-DcsPassthroughsSnapshot -Server "SSVVM05" -VirtualDisk "Virtual disk 6" -Disk $disk
The cmdlet Get-DcsPhysicalDisk is invoked to get the PhysicalDiskData object for the disk and the object is stored in the variable $disk. The cmdlet Add-DcsPassthroughSnapshot is invoked to create a snapshot on the server named "SSVVM05" using the virtual disk named "Virtual disk 6" as the snapshot source and the passthrough disk identified in the variable $disk. The SnapshotData object is returned.
SourceLogicalDiskId | : | 9e56ad73-6e66-49d1-93cd-52a07e177c93 |
DestinationLogicalDiskId | : | 0bc51a70-7ba0-4f29-83a8-a89dd3342ba1 |
Type | : | Full |
TimeStamp | : | 4/20/2016 9:19:05 AM |
ActiveOperation | : | Snap |
State | : | Healthy |
Failure | : | NoFailure |
Sequencenumber | : | 6585 |
Id | : | V.{680B0BB6-F2B0-11E5-80E7-00155D138914}-00000007--V |
Caption | : | [PT] Virtual disk 6 @ 4/20/2016 9:19:05 AM |
ExtendedCaption | : | [PT] Virtual disk 6 @ 4/20/2016 9:19:05 AM on |
Internal | : | False |