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サーバー上にある既存の保護グループの名前を変更します。

■構文

Add-DPMDisk [-DPMDisk] <Disk[]> [-Confirm [<SwitchParameter>]]
     [-WhatIf [<SwitchParameter>]] [<CommonParameters>]

■説明

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

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

■パラメーター

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

必須true
位置2
規定値
パイプライン入力を許可するfalse
ワイルドカード文字を許可するfalse

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

必須false
位置named
規定値
パイプライン入力を許可するfalse
ワイルドカード文字を許可するfalse

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

必須true
位置1
規定値
パイプライン入力を許可するtrue (ByValue)
ワイルドカード文字を許可するfalse

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

必須false
位置named
規定値
パイプライン入力を許可するfalse
ワイルドカード文字を許可するfalse

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

必須false
位置named
規定値
パイプライン入力を許可するfalse
ワイルドカード文字を許可するfalse

<CommonParameters>
このコマンドレットは、次の共通パラメーターをサポートします: VerboseDebugErrorActionErrorVariableWarningActionWarningVariableOutBuffer、および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に変更されます。

[参考]

コメント

  1. […] DPM 2012のDPM管理シェルで使用できるコマンドレット (Rename-DPMProtectionGroup) について | 焦げloghttp://kogelog.com/2012/08/06/20120806-05/ […]