Refresh-VolumeGroup
SYNOPSIS
Refreshes the contents of a volume group from another volume group in the same family.
SYNTAX
ByNameVolumeGroupName (Default)
Refresh-VolumeGroup [-Cluster] <Cluster> [-Name] <String> -VolumeGroupName <String> [-SkipBackupSnapshot] [-BackupSnapshotName] [-BackupSnapshotDescription]
[-Confirm] [-Force] [-PassThru] [-WhatIf] [<CommonParameters>]
ByNameVolumeGroupId
Refresh-VolumeGroup [-Cluster] <Cluster> [-Name] <String> -VolumeGroupId <String> [-SkipBackupSnapshot] [-BackupSnapshotName] [-BackupSnapshotDescription]
[-Confirm] [-Force] [-PassThru] [-WhatIf] [<CommonParameters>]
ByNameSnapshotName
Refresh-VolumeGroup [-Cluster] <Cluster> [-Name] <String> -SnapshotName <String> [-SkipBackupSnapshot] [-BackupSnapshotName] [-BackupSnapshotDescription]
[-Confirm] [-Force] [-PassThru] [-WhatIf] [<CommonParameters>]
ByNameSnapshotId
Refresh-VolumeGroup [-Cluster] <Cluster> [-Name] <String> -SnapshotId <String> [-SkipBackupSnapshot] [-BackupSnapshotName] [-BackupSnapshotDescription]
[-Confirm] [-Force] [-PassThru] [-WhatIf] [<CommonParameters>]
ByIdVolumeGroupName
Refresh-VolumeGroup [-Cluster] <Cluster> -Id <String> -VolumeGroupName <String> [-SkipBackupSnapshot] [-BackupSnapshotName] [-BackupSnapshotDescription]
[-Confirm] [-Force] [-PassThru] [-WhatIf] [<CommonParameters>]
ByIdVolumeGroupId
Refresh-VolumeGroup [-Cluster] <Cluster> -Id <String> -VolumeGroupId <String> [-SkipBackupSnapshot] [-BackupSnapshotName] [-BackupSnapshotDescription]
[-Confirm] [-Force] [-PassThru] [-WhatIf] [<CommonParameters>]
ByIdSnapshotName
Refresh-VolumeGroup [-Cluster] <Cluster> -Id <String> -SnapshotName <String> [-SkipBackupSnapshot] [-BackupSnapshotName] [-BackupSnapshotDescription]
[-Confirm] [-Force] [-PassThru] [-WhatIf] [<CommonParameters>]
ByIdSnapshotId
Refresh-VolumeGroup [-Cluster] <Cluster> -Id <String> -SnapshotId <String> [-SkipBackupSnapshot] [-BackupSnapshotName] [-BackupSnapshotDescription]
[-Confirm] [-Force] [-PassThru] [-WhatIf] [<CommonParameters>]
DESCRIPTION
Refreshes the contents of a primary or clone volume group from another primary, clone, or snapshot in the same family. Creates a backup snapshot of the volume group before refresh by default. Use BackupSnapshotName to create a snapshot with name of choice, otherwise system generated name will be used. Use SkipBackupSnapshot if no backup snapshot is required.
EXAMPLES
Example 1
PS C:\> Refresh-VolumeGroup -Cluster $cluster -Id volumeGroupId1 -VolumeGroupId sourceVolumeGroupId1
Where $cluster is a PowerStore cluster instance. Refreshes volume group with Id volumeGroupId1 from volume group with Id sourceVolumeGroupId1 and backup snapshot will be created using a system generated timestamp.
Example 2
PS C:\> Refresh-VolumeGroup -Cluster $cluster -Name volumeGroupName1 -VolumeGroupId sourceVolumeGroupId1 -BackupSnapshotName snapName1
Where $cluster is a PowerStore cluster instance. Refreshes volume group with name volumeGroupName1 from volume group using Id sourceVolumeGroupId1 and backup snapshot will be created with snapName1.
Example 3
PS C:\> Refresh-VolumeGroup -Cluster $cluster -Name volumeGroupName1 -VolumeGroupName sourceVolumeGroupId1
Where $cluster is a PowerStore cluster instance. Refreshes volume group with name volumeGroupName1 from volume group using name sourceVolumeGroupId1 and backup snapshot will be created using a system generated timestamp.
Example 4
PS C:\> Refresh-VolumeGroup -Cluster $cluster -Name volumeGroupName1 -SnapshotName snapshotName1 -SkipBackupSnapshot
Where $cluster is a PowerStore cluster instance. Refreshes volume group with name volumeGroupName1 from snapshot using name snapshotName1 and no backup snapshot will be created before the refresh operation.
PARAMETERS
-Cluster
A PowerStore Cluster instance.
Type: Cluster
Parameter Sets: (All)
Aliases:
Required: True
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Name
Name of volume group to refresh.
Type: String
Parameter Sets: ByNameVolumeGroupId, ByNameVolumeGroupName, ByNameSnapshotId, ByNameSnapshotName
Aliases:
Required: True
Position: 1
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Id
Id of volume group to refresh.
Type: String
Parameter Sets: ByIdVolumeGroupId, ByIdVolumeGroupName, ByIdSnapshotId, ByIdSnapshotName
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-VolumeGroupName
Name of volume group to refresh from.
Type: String
Parameter Sets: ByIdVolumeGroupName, ByNameVolumeGroupName
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-VolumeGroupId
Id of volume group to refresh from.
Type: String
Parameter Sets: ByIdVolumeGroupId, ByNameVolumeGroupId
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-SnapshotName
Name of snapshot to refresh from.
Type: String
Parameter Sets: ByIdSnapshotName, ByNameSnapshotName
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-SnapshotId
Id of snapshot to refresh from.
Type: String
Parameter Sets: ByIdSnapshotId, ByNameSnapshotId
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-SkipBackupSnapshot
Set if no backup snapshot is required.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-BackupSnapshotName
Backup snapshot name.
Type: String
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-BackupSnapshotDescription
Backup snapshot description.
Type: String
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
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
Suppress confirmation prompt before refresh.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PassThru
Returns refreshed volume group instance.
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.