DPM 2012のDPM管理シェルで使用できるコマンドレット (Rename-DPMProtectionGroup) について

System Center 2012 Data Protection Manager (DPM 2012) のDPM管理シェルは、PowerShellを用いたコマンドラインインタフェースです。

DPM管理シェルは、DPM 2012の管理を目的として様々なコマンドレットが用意されていますが、 コマンドレットのヘルプについて、英語の情報のみのようです。

このヘルプ情報について、オンライン上で日本語として確認したいと思い、本ブログ上で纏めてみることにしました (内容については「Get-Help」コマンドレットの-Fullオプションを用いて実行した結果を編集、意訳したものとなります)。

この記事では、「Rename-DPMProtectionGroup (Rename-ProtectionGroup)」コマンドレットについて記載します (他のコマンドレットについては、「DPM 2012のDPM管理シェルで使用できるコマンドレット一覧について」を参照)。

■名前

Rename-DPMProtectionGroup (Rename-ProtectionGroup)

■概要

DPMサーバー上にある既存の保護グループの名前を変更します。

■構文

■説明

Rename-DPMProtectionGroupコマンドレットは、既存の保護グループを新しい名前に変更します。保護グループの名前を変更するには、次の手順を実行します。

1. Get-ProtectionGroupコマンドレットを使用して保護グループを取得します。
2. Get-ModifiableProtectionGroupコマンドレットを使用して保護グループを変更可能にします。
3. Rename-ProtectionGroupコマンドレットを使用して保護グループの名前を変更します。
4. Set-ProtectionGroupコマンドレットを使用してその変更を保存します。

■パラメーター

-NewName <String>
オブジェクトの新しい名前。

-PassThru <SwitchParameter>
-PassThruパラメーターは DPM の多くのコマンドで使用でき、既定の出力がない場合に関連オブジェクトを返します。-PassThruパラメーターを使用すると、上記のコマンドレットをパイプラインの一部にすることができます。

-ProtectionGroup <ProtectionGroup>
保護グループの名前。

-Confirm [<SwitchParameter>]
コマンドを実行する前に実行の是非を確認するプロンプトを表示します。

-WhatIf [<SwitchParameter>]
実際にコマンドを実行せずに、コマンドを実行すると何が起きるかを出力します。

<CommonParameters>
このコマンドレットは、次の共通パラメーターをサポートします: Verbose、Debug、ErrorAction、ErrorVariable、WarningAction、WarningVariable、OutBuffer、およびOutVariable。詳細については、「get-help about_commonparameters」と入力してヘルプを参照してください。

■入力

■出力

ProtectionGroup

■メモ

詳細については、「Get-Help Rename-DPMProtectionGroup -detailed」と入力してください。
技術情報については、「Get-Help Rename-DPMProtectionGroup-full」と入力してください。

■例

例1

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

このコマンドにより、保護グループの名前がTrial PGからModified PGに変更されます。

[参考]

• DPM Cmdlet Help – System Center 2012 Data Protection Manager
  http://technet.microsoft.com/en-us/library/hh881679.aspx
• Rename-DPMProtectionGroup – System Center 2012 Data Protection Manager
  http://technet.microsoft.com/en-us/library/hh881734.aspx
• DPM 2010のDPM管理シェルで使用できるコマンドレット (Rename-ProtectionGroup) について « 焦げlog
  https://kogelog.com/2011/09/15/20110915-02/