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

スポンサーリンク

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

DPM 管理シェルは、デスクトップ上のアイコン、もしくはスタート画面の [DPM 管理シェル] を選択、クリックすることで起動することが可能です。

SC 2012 Service Pack1 RollUp 2 – DPM 以降と同様に、SC 2012 R2 – DPM の管理を目的として様々なコマンドレットが DPM 管理シェルに用意されていますが、 コマンドレットのヘルプについては、日本語の情報は公開されていません。

このヘルプ情報について、 「Get-Help」コマンドレットの -Full オプションを用いて実行した結果を編集、意訳しました。

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

■名前

Rename-DPMProtectionGroup

■概要

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

■構文

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

■説明

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

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

■パラメーター

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

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

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

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

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

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

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

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

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

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

<CommonParameters>
このコマンドレットは、次の共通パラメーターをサポートします: VerboseDebugErrorActionErrorVariableWarningActionWarningVariableOutBuffer, PipelineVariable、および OutVariable。詳細については、about_CommonParameters を参照してください。

■入力

  • 入力タイプは、コマンドレットへパイプすることができるオブジェクトのタイプです。

■出力

  • 出力タイプは、コマンドレットが発行するオブジェクトのタイプです。
    • ProtectionGroup

■メモ

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

■エイリアス

  • Rename-ProtectionGroup

■例

例 1

$pg = Get-ProtectionGroup - DPMServerName &quot;TestingServer&quot;
$mpg = Get-ModifiableProtectionGroup $pg
Rename-DPMProtectionGroup -ProtectionGroup $mpg -NewName &quot;ModifiedPG&quot;
Set-ProtectionGroup $mpg

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

■関連するトピック

[参考]