Unlink-StorageGroupSnapshot
SYNOPSIS
Unlinks a storage group snapshot.
SYNTAX
Unlink-StorageGroupSnapshot [-Unisphere] <UnisphereServer> [-ArrayId] <String> [-StorageGroupId] <String>
[-SnapshotId] <String> [-SnapId] <Int64> [-TargetStorageGroupId] <String> [-Confirm] [-Force] [-WhatIf]
[<CommonParameters>]
DESCRIPTION
Unlinks a storage group snapshot from a target storage group.
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:\> Unlink-StorageGroupSnapshot -Unisphere $unisphere -ArrayId 000123456789 -StorageGroupId sg1 -SnapshotId sg1snap -SnapId 41212187393 -TargetStorageGroupId sg1target
Where $unisphere is a Unisphere server instance. Unlinks the snapshot of storage group sg1 from 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 unlink from.
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.