NAME

Update-DcsSnapshot

SYNOPSIS

Updates a snapshot with the changes that have occurred on the source virtual disk since the snapshot was created or last updated. This operation can also be performed on a snapshot group.

SYNTAX

Update-DcsSnapshot   -Snapshot <Object>   [ -Yes]   [ -Connection <String> ]   [ -PipelineVariable <String> ]   [ -WhatIf]   [ -Confirm]

Update-DcsSnapshot   -SnapshotGroup <Object>   [ -Yes]   [ -Connection <String> ]   [ -PipelineVariable <String> ]   [ -WhatIf]   [ -Confirm]

DESCRIPTION

Updates a snapshot with the changes that have occurred on the source virtual disk since the snapshot was created or last updated. This operation can also be performed on a snapshot group.

PARAMETERS

-Snapshot<Object>
SnapshotData object, name, or ID that identifies the snapshot to be updated.

Required: true
Position: named
Default value:
Accept pipeline input: true (ByValue)
Accept wildcard characters: false

-Yes<SwitchParameter>
Updating a snapshot is an operation that requires confirmation. Specify this parameter to confirm your intention to update the snapshot and prevent user interaction during scripted scenarios. If not specified, user interaction will be required.

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

-WhatIf<SwitchParameter>

Required: false
Position: named
Default value:
Accept pipeline input: false
Accept wildcard characters: false

-Confirm<SwitchParameter>

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 to update. Use this parameter to update all eligible snapshots in the snapshot group.

Required: true
Position: named
Default value:
Accept pipeline input: false
Accept wildcard characters: false

INPUTS

SnapshotData : Object that identifies and describes the snapshot.

OUTPUTS

SnapshotData : Object that identifies and describes the snapshot.

NOTES

Also see ConvertTo-DcsFullSnapshot, Split-DcsSnapshot, Get-DcsSnapshot.

EXAMPLES


-------------- Example 1 Updates a snapshot specified by name --------------
Update-DcsSnapshot -Snapshot "Virtual disk 1 @ 9/20/2011 12:08:03 PM" -Yes
		

Updates the snapshot named "Virtual disk 1 @ 9/20/2011 12:08:03 PM". The Yes parameter was included to eliminate the need to confirm the operation.

SourceLogicalDiskId:LD:4A58C0F4-59AB-4A16-A559-2ED9778CC2B2_V.{412f1a8c-e2da-11e0-afaa-00155d11e921}-00000004
DestinationLogicalDiskId:LD:4A58C0F4-59AB-4A16-A559-2ED9778CC2B2_V.{412f1a8c-e2da-11e0-afaa-00155d11e921}-00000006
Type:Differential
TimeStamp:9/20/2011 12:33:57 PM
ActiveOperation:NoOperation
State:Healthy
Failure:NoFailure
Id:V.{412F1A8C-E2DA-11E0-AFAA-00155D11E921}-00000004--V.{412F1A8C-E2DA-11E0-AFAA-00155D11E921}-00000006
Caption:Virtual disk 1 @ 9/20/2011 12:08:03 PM
ExtendedCaption:Virtual disk 1 @ 9/20/2011 12:08:03 PM on SSV1
Internal:False
   

-------------- Example 2 Updates all snapshots by piping objects --------------
Get-DcsSnapshot | Update-DcsSnapshot -Yes
		

The cmdlet Get-DcsSnapshot is invoked to obtain SnapshotData objects for all snapshots in the server group. The objects are piped to Update-DcsSnapshot to update those snapshots. The Yes parameter was included to eliminate the need to confirm the operation.

SourceLogicalDiskId:LD:4A58C0F4-59AB-4A16-A559-2ED9778CC2B2_V.{412f1a8c-e2da-11e0-afaa-00155d11e921}-00000004
DestinationLogicalDiskId:LD:4A58C0F4-59AB-4A16-A559-2ED9778CC2B2_V.{412f1a8c-e2da-11e0-afaa-00155d11e921}-00000006
Type:Differential
TimeStamp:9/20/2011 12:08:17 PM
ActiveOperation:NoOperation
State:Healthy
Failure:NoFailure
Id:V.{412F1A8C-E2DA-11E0-AFAA-00155D11E921}-00000004--V.{412F1A8C-E2DA-11E0-AFAA-00155D11E921}-00000006
Caption:Virtual disk 1 @ 9/20/2011 12:08:03 PM
ExtendedCaption:Virtual disk 1 @ 9/20/2011 12:08:03 PM on SSV1
Internal:False
   
SourceLogicalDiskId:LD:4A58C0F4-59AB-4A16-A559-2ED9778CC2B2_V.{412f1a8c-e2da-11e0-afaa-00155d11e921}-00000005
DestinationLogicalDiskId:LD:4A58C0F4-59AB-4A16-A559-2ED9778CC2B2_V.{412f1a8c-e2da-11e0-afaa-00155d11e921}-00000008
Type:Differential
TimeStamp:9/20/2011 12:29:09 PM
ActiveOperation:NoOperation
State:Healthy
Failure:NoFailure
Id:V.{412F1A8C-E2DA-11E0-AFAA-00155D11E921}-00000005--V.{412F1A8C-E2DA-11E0-AFAA-00155D11E921}-00000008
Caption:Virtual disk 2 @ 9/20/2011 12:29:00 PM
ExtendedCaption:Virtual disk 2 @ 9/20/2011 12:29:00 PM on SSV1
Internal:False