System Center 2016 – Data Protection Manager の DPM 管理シェルで使用できるコマンドレット (Rename-DPMProtectionGroup) について

スポンサーリンク

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

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

DPM 2016 の管理を目的として様々なコマンドレットが DPM 管理シェルに用意されていますが、 コマンドレットのヘルプについては、日本語の情報は公開されていません。

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

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

Rename-DPMProtectionGroup コマンドレット

名前

Rename-DPMProtectionGroup

エイリアス

Rename-ProtectionGroup

概要

保護グループ名を変更します。

構文

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

説明

Rename-DPMProtectionGroup コマンドレットは、System Center 2016 – Data Protection Manager (DPM) サーバー上の保護グループ名を変更します。保護グループ名の変更のプロセスは、次のステップで実施します。

  1. Get-DPMProtectionGroup コマンドレットを用いて保護グループを取得します。
  2. Get-DPMModifiableProtectionGroup コマンドレットを用いて保護グループを編集可能にします。
  3. Rename-DPMProtectionGroup コマンドレットを用いて保護グループ名を変更します。
  4. Set-DPMProtectionGroup コマンドレットを用いて変更内容を保存します。

パラメーター

-NewName <String>

新しい保護グループ名を指定します。

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

-PassThru [<SwitchParameter>]

作業中の項目を表すオブジェクトを返します。既定では、このコマンドレットは、出力を生成しません。

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

-ProtectionGroup <ProtectionGroup>

このコマンドレットが、名前を変更する保護グループを指定します。ProtectionGroup オブジェクトを取得するには、Get-DPMProtectionGroup コマンドレットを用います。

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

-Confirm [<SwitchParameter>]

コマンドレットを実行する前に確認のプロンプトを表示します。

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

-WhatIf [<SwitchParameter>]

コマンドレットを実行する場合、何が起きるかを表示します。コマンドレットは実行されません。

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

<CommonParameters>

このコマンドレットは、次の共通パラメーターをサポートします: -Verbose-Debug-ErrorAction-ErrorVariable-WarningAction-WarningVariable-OutBuffer-PipelineVariable、および -OutVariable。詳細については、about_CommonParameters を参照してください。

入力

入力の種類は、コマンドレットにパイプ可能なオブジェクトの種類です。

出力

出力の種類は、コマンドレットが発行するオブジェクトの種類です。

  • ProtectionGroup

例 1 : 保護グループ名を変更する

$PGroup = Get-DPMProtectionGroup -DPMServerName "DPMServer02"
$MPGroup = Get-DPMModifiableProtectionGroup -ProtectionGroup $PGroup
Rename-DPMProtectionGroup -ProtectionGroup $MPGroup -NewName "ProtectGroup02"
Set-DPMProtectionGroup -ProtectionGroup $MPGroup

最初のコマンドは、DPM サーバー「DPMServer02」の保護グループを取得し、変数 $PGroup に格納します。

2 番目のコマンドは、編集可能モードで保護グループを取得、変数 $MPGroup に格納します。

3 番目のコマンドは、$MPGroup の保護グループ名を「ProtectGroup02」に変更します。

4 番目のコマンドは、$MPGroup の保護グループで実行した DPM サーバーのすべての変更内容を保存します。

関連するリンク

  • Update-DPMProtectionGroup
  • Get-DPMProtectionGroup
  • Set-DPMProtectionGroup
  • New-DPMProtectionGroup

参考