Enable-EmcReplicaCopyImageAccess

Enables a replica copy image access so that it can be available for mounting. Replication changes are not propagated to the copy while image access is enabled.

 

Syntax

Enable-EmcReplicaCopyImageAccess -Copy <ReplicaCopy> [-Force] [-Silent] [-WhatIf] [-Confirm] [<CommonParameters>]

 

Parameters

-Copy <ReplicaCopy>

Attributes: Required, Position: named

The replica copy for which image access will be enabled.

 

-Force <SwitchParameter>

Attributes: Optional, Position: named

Allows the cmdlet to continue without asking for user confirmation.

 

-ImageAccessScenario <ImageAccessScenario>

Attributes: Optional, Position: named

The type of operation for a replica copy. The available options are Failover and RecoverProduction.

 

-Snapshot <SnapshotBase>

Attributes: Optional, Position: named

Point-in-time marked by the system for the recovery.

 

-Silent <SwitchParameter>

Attributes: Optional, Position: named

Turns off all the informational and verbose messages. However, it still displays errors.

 

-WhatIf <SwitchParameter>

Attributes: Optional, Position: named

Describes what would happen if you executed the command without actually executing the command.

 

-Confirm <SwitchParameter>

Attributes: Optional, Position: named

Prompts you for confirmation before executing the command.

 

<CommonParameters>

This cmdlet supports these common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, and OutVariable. Type get-help about_commonparameters for more details.

 

Examples

-------------- Example 1 --------------

C:\PS>$service = Get-EmcReplicationService -ID *60*

C:\PS>cluster = Get-EmcReplicationServiceCluster -ReplicationService $service

C:\PS>$copy = Get-EmcReplicaCopy -ReplicationServiceCluster $cluster -Role RemoteCopy -ID RP_PS_TEST_CR

C:\PS>Enable-EmcReplicaCopy –Copy $copy

C:\PS>Enable-EmcReplicaCopyImageAccess -Copy $copy

Enables image access for a replica copy.

 

-------------- Example 2 --------------

C:\PS>$service = Get-EmcReplicationService -ID *60*

C:\PS>cluster = Get-EmcReplicationServiceCluster -ReplicationService $service

C:\PS>$copy = Get-EmcReplicaCopy -ReplicationServiceCluster $cluster -Role RemoteCopy -ID RP_PS_TEST_CR

C:\PS>Enable-EmcReplicaCopy –Copy $copy

C:\PS>$snapshots = Get-EmcReplicaCopySnapshots -Copy $copy

C:\PS>Enable-EmcReplicaCopyImageAccess -Copy $copy -Snapshot $snapshots[0]

Enables a replica copy's image access for the retrieved snapshot.

 

-------------- Example 3 --------------

C:\PS>$service = Get-EmcReplicationService -ID *60*

C:\PS>cluster = Get-EmcReplicationServiceCluster -ReplicationService $service

C:\PS>$copy = Get-EmcReplicaCopy -ReplicationServiceCluster $cluster -Role RemoteCopy -ID RP_PS_TEST_CR

C:\PS>Enable-EmcReplicaCopy –Copy $copy

C:\PS>$snapshots = Get-EmcReplicaCopySnapshots -Copy $copy

C:\PS>$snapshot = $snapshots[1].PreviousSnapshot

C:\PS>Enable-EmcReplicaCopyImageAccess -Copy $copy -Snapshot $snapshot

Enables a replica copy's image access for the previous snapshot of the retrieved snapshot.