Link-StorageGroupSnapshot
SYNOPSIS
Links a storage group snapshot to a storage group.
SYNTAX
Link-StorageGroupSnapshot [-Unisphere] <UnisphereServer> [-ArrayId] <String> [-StorageGroupId] <String>
[-SnapshotId] <String> [-SnapId] <Int64> [-TargetStorageGroupId] <String> [-Confirm] [-Force] [-WhatIf]
[<CommonParameters>]
DESCRIPTION
Links a storage group snapshot to a storage group. If the target storage group does not exist then it will be created. Any pre-existing data that was exclusive to the target will be lost during a link.
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:\> Link-StorageGroupSnapshot -Unisphere $unisphere -ArrayId 000123456789 -StorageGroupId sg1 -SnapshotId sg1snap -SnapId 41212187393 -TargetStorageGroupId sg1target
Where $unisphere is a Unisphere server instance. Links the snapshot sg1snap with snap ID 41212187393 to the storage group sg1target. If the storage group does not exist then it will be created.
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 link 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.