Rename-ProtectionGroup

Renames an existing protection group on the DPM server.

Rename-ProtectionGroup [-ProtectionGroup] <ProtectionGroup> [-NewName] <String> [-PassThru <SwitchParameter>] [<CommonParameters>]

The Rename-ProtectionGroup cmdlet renames an existing protection group with a new name. The process of renaming a protection group involves the following steps –
1. Retrieve the protection group using the Get-ProtectionGroup cmdlet.
2. Make the protection group modifiable using the Get-ModifiableProtectionGroup cmdlet.
3. Rename the protection group using the Rename-ProtectionGroup cmdlet.
4. Save the changes using the Set-ProtectionGroup cmdlet.

The name of a protection group.

Attributes

The new name for an object.

Attributes

The -PassThru parameter can be used with many commands in DPM to return a related object in cases where there is no default output. Using the PassThru parameter allows such cmdlets to be part of a pipeline.

Attributes

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

The input type is the type of the objects that you can pipe to the cmdlet. The return type is the type of the objects that the cmdlet emits.

• For more information, type "Get-Help Rename-ProtectionGroup -detailed".
  For technical information, type "Get-Help Rename-ProtectionGroup -full".

  Additionally, any updated information about the cmdlet will be available at https://go.microsoft.com/fwlink/?LinkId=95130.

$pg = Get-ProtectionGroup - DPMServerName 'TestingServer' 
$mpg = Get-ModifiableProtectionGroup $pg 
Rename-ProtectionGroup -ProtectionGroup $mpg -NewName 'ModifiedPG' 
Set-ProtectionGroup $mpg 
                           

This command renames the protection group Trial PG to Modified PG.