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

スポンサーリンク
Ori and the Blind Forest

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

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

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

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

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

Remove-DPMTape コマンドレット

名前

Remove-DPMTape

エイリアス

Remove-Tape

概要

DPM ライブラリからテープを削除します。

構文

Remove-DPMTape [-DPMLibrary] <Library> [-Tape] <Media[]> [-Async] [-JobStateChangedEventHandler <JobStateChangedEventHandler>] [-Confirm] [-WhatIf] [<CommonParameters>]

説明

Remove-DPMTape コマンドレットは、System Center 2016 – Data Protection Manager (DPM) ライブラリからテープを削除します。

パラメーター

-Async [<SwitchParameter>]

コマンドが非同期で実行する場合に指定します。コマンドが非同期で実行される場合、ジョブ完了までに時間を要する場合でも、コマンド プロンプトはすぐに返ります。

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

-DPMLibrary <Library>

このコマンドレットが、テープを削除する DPM ライブラリを指定します。DPM ライブラリ オブジェクトを取得するには、Get-DPMLibrary コマンドレットを用います。

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

-JobStateChangedEventHandler [<JobStateChangedEventHandler>]

Job.StateChanged イベント用のイベント ハンドラーを指定します。コマンドレットに基づくグラフィカル ユーザー インターフェイスを構築するために、このパラメーターを用います。DPM 管理シェルではこのパラメーターは使用できません。

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

-Tape <Media[]>

このコマンドレットが、削除するテープ オブジェクトの配列を指定します。Tape オブジェクトを取得するには、Get-DPMTape コマンドレットを用います。

必須 true
位置 2
既定値 なし
パイプライン入力を許可する 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 を参照してください。

入力

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

出力

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

例 1 : ライブラリからテープを削除する

$DpmLibrary = Get-DPMLibrary -DPMServerName "Contoso-DPMServer"
$DpmTape = Get-DPMTape -DPMLibrary $DpmLibrary
Unlock-DPMLibraryDoor -DPMLibrary $DpmLibrary
Remove-DPMTape -DPMLibrary $DpmLibrary -Tape $DpmTape[2]

最初のコマンドは、Get-DPMLibrary コマンドレットを用いて DPM サーバー「Contoso-DPMServer」のライブラリを取得し、変数 $DpmLibrary を格納します。

2 番目のコマンドは、Get-DPMTape コマンドレットを用いてテープ オブジェクトを取得、変数 $DpmTape に格納します。

3 番目のコマンドは、Unlock-DPMLibraryDoor コマンドレットを用いてテープのドアをロック解除しいます。

最後のコマンドは、ライブラリから 3 番目のテープを削除します。

関連するリンク

  • Add-DPMTape
  • Get-DPMLibrary
  • Get-DPMTape
  • Set-DPMTape
  • Unlock-DPMLibraryDoor

参考