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

スポンサーリンク

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

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

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

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

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

Start-DPMLibraryInventory コマンドレット

名前

Start-DPMLibraryInventory

概要

DPM ライブラリ内のテープのインベントリを開始します。

構文

Start-DPMLibraryInventory [-DPMLibrary] <Library> [-FastInventory] [-JobStateChangedEventHandler <JobStateChangedEventHandler>] [-Confirm] [-WhatIf] [<CommonParameters>]

Start-DPMLibraryInventory [-DPMLibrary] <Library> [-JobStateChangedEventHandler <JobStateChangedEventHandler>] [-Tape <Media[]>] -DetailedInventory [-Confirm] [-WhatIf] [<CommonParameters>]

説明

Start-DPMLibraryInventory コマンドレットは、 System Center 2016 – Data Protection Manager (DPM) ライブラリ内のテープのインベントリを開始します。DPM は、ライブラリ内にバーコードあり / なしのテープを検出します。 詳細インベントリ、もしくは高速インベントリのどちらかを選択することが可能です。

詳細インベントリでは、DPM がライブラリ内のテープ ヘッダー領域を読み取り、各テープ上のオンメディア識別子(OMID)を識別します。

バーコード リーダーを持つライブラリの高速インベントリでは、DPM はライブラリ内の各テープのバーコードを読み取ります。ライブラリにバーコード リーダーがない、もしくはテープにバーコードがない場合、DPM はテープのヘッダー領域を読み取り、OMID を識別します。

パラメーター

-DetailedInventory <SwitchParameter>

DPM が、指定したライブラリ上で詳細インベントリを実行する場合に指定します。

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

-DPMLibrary <Library>

このコマンドレットがインベントリを開始する DPM ライブラリ オブジェクトを指定します。DPM ライブラリ オブジェクトを取得するために、Get-DPMLibrary コマンドレットを用います。

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

-FastInventory [<SwitchParameter>]

DPM が指定したライブラリで高速インベントリを実行する場合に指定します。

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

-JobStateChangedEventHandler [<JobStateChangedEventHandler>]

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

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

-Tape [<Media[]>]

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

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

入力

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

出力

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

  • Job

例 1 : 高速インベントリを実行する

$DpmLibrary = Get-DPMLibrary -DPMServerName "DPMServer07"
Start-DPMLibraryInventory -DPMLibrary $DpmLibrary -FastInventory

最初のコマンドは、Get-DPMLibrary コマンドレットを用いて DPM サーバーに関連付けられたライブラリを取得、変数 $DpmLibrary に格納します。

2 番目のコマンドは、$DpmLibrary に格納されているライブラリ オブジェクト上のインベントリを開始します。コマンドは高速インベントリで開始するために、-FastInventory パラメーターを用います

例 2 : 詳細インベントリを実行する

$DpmLibrary = Get-DPMLibrary -DPMServerName "DPMServer07"
Start-DPMLibraryInventory -DPMLibrary $DpmLibrary -DetailedInventory

最初のコマンドは、Get-DPMLibrary コマンドレットを用いて DPM サーバーに関連付けられたライブラリを取得、変数 $DpmLibrary に格納します。

2 番目のコマンドは、$DpmLibrary に格納されているライブラリ オブジェクト上のインベントリを開始します。コマンドは詳細インベントリで開始するために、-DetailedInventory パラメーターを用います。

関連するリンク

  • Get-DPMLibrary
  • Get-DPMTape

参考