Relink-StorageGroupSnapshot

SYNOPSIS

Relinks a storage group snapshot to a storage group.

SYNTAX

Relink-StorageGroupSnapshot [-Unisphere] <UnisphereServer> [-ArrayId] <String> [-StorageGroupId] <String>
 [-SnapshotId] <String> [-SnapId] <Int64> [-TargetStorageGroupId] <String> [-Confirm] [-Force] [-WhatIf]
 [<CommonParameters>]

DESCRIPTION

Relinks a storage group snapshot to a target storage group. Any pre-existing data that was exclusive to the target will be lost during a relink.

If the -Force flag is specified then the operation will be attempted even if the devices are not in the required state for the operation.

The snapshot instance will be returned on success. Note that the linked state of the snapshot may not be represented in the return instance as there is a delay in Unisphere getting updated information. If updated snapshot info is desired then use the Get-StorageGroupSnapshot cmdlet to get updated state information. It may take a few seconds for the state to be updated in Unisphere.

EXAMPLES

Example 1

PS C:\> Relink-StorageGroupSnapshot -Unisphere $unisphere -ArrayId 000123456789 -StorageGroupId sg1 -SnapshotId sg1snap -SnapId 41212187393 -TargetStorageGroupId sg1target

Where $unisphere is a Unisphere server instance. Relinks the snapshot sg1snap with snap ID 41212187393 to the storage group sg1target.

PARAMETERS

-Unisphere

The Unisphere server object.

Type: UnisphereServer
Parameter Sets: (All)
Aliases:

Required: True
Position: 0
Default value: None
Accept pipeline input: True (ByPropertyName, ByValue)
Accept wildcard characters: False

-ArrayId

The PowerMax array ID.

Type: String
Parameter Sets: (All)
Aliases:

Required: True
Position: 1
Default value: None
Accept pipeline input: True (ByPropertyName, ByValue)
Accept wildcard characters: False

-StorageGroupId

The storage group ID.

Type: String
Parameter Sets: (All)
Aliases:

Required: True
Position: 2
Default value: None
Accept pipeline input: True (ByPropertyName, ByValue)
Accept wildcard characters: False

-SnapshotId

The snapshot ID.

Type: String
Parameter Sets: (All)
Aliases:

Required: True
Position: 3
Default value: None
Accept pipeline input: True (ByPropertyName, ByValue)
Accept wildcard characters: False

-SnapId

The snap ID.

Type: Int64
Parameter Sets: (All)
Aliases:

Required: True
Position: 4
Default value: None
Accept pipeline input: True (ByPropertyName, ByValue)
Accept wildcard characters: False

-TargetStorageGroupId

The storage group to relink to.

Type: String
Parameter Sets: (All)
Aliases:

Required: True
Position: 5
Default value: None
Accept pipeline input: True (ByPropertyName, ByValue)
Accept wildcard characters: False

-Confirm

Prompts you for confirmation before running the cmdlet.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Force

Skips confirmation before performing the operation.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

INPUTS

Dell.PowerMax.Management.Model.UnisphereServer

System.String

System.Int64

OUTPUTS

Dell.PowerMax.Management.Model.StorageGroupSnapshot

NOTES