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


-------------- Example 1 Creates a snapshot that is a passthrough virtual disk. --------------
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