DPM 2012のDPM管理シェルで使用できるコマンドレット (Get-DPMDatasource) について

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

DPM管理シェルは、DPM 2012の管理を目的として様々なコマンドレットが用意されていますが、 コマンドレットのヘルプについて、英語の情報のみのようです。

このヘルプ情報について、オンライン上で日本語として確認したいと思い、本ブログ上で纏めてみることにしました (内容については「Get-Help」コマンドレットの-Fullオプションを用いて実行した結果を編集、意訳したものとなります)。

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

■名前

Get-DPMDatasource (Get-Datasource)

■概要

コンピューターまたは保護グループで保護されたデータおよび保護されていないデータの一覧を取得します。

■構文

Get-DPMDatasource [-DPMServerName] <String> [-Inactive <SwitchParameter>]      [<CommonParameters>] Get-DPMDatasource [-DPMServerName] <String> [-ComputerName] <String[]>      [-Async <SwitchParameter>] [<CommonParameters>] Get-DPMDatasource [-ProductionServer] <ProductionServer> [-Async <SwitchParameter>]      [-GetVolumesWithoutMountPoints <SwitchParameter>]      [-IgnoreDPMInformation <SwitchParameter>] [-Inquire <SwitchParameter>]      [-Replica <SwitchParameter>] [-Tag <Object>] [<CommonParameters>] Get-DPMDatasource [-DPMServerName] <String> [-Path] <Path>      [[-ProductionServerName] <String>] [<CommonParameters>] Get-DPMDatasource [-ProtectionGroup] <ProtectionGroup> [<CommonParameters>]

■説明

Get-Datasourceコマンドレットは、コンピューター上で保護されたデータおよび保護されていないデータの一覧を取得します。出力には、保護を実行できるレベルのオブジェクトのみが表示されます。データ ソース内のファイルを表示するには、Get-ChildDatasourceコマンドレットを使用します。

• -Inquireパラメーターを使用すると、保護されたコンピューター上で利用可能なすべてのデータ ソースが返されます。
• DPMサーバー上で保護されたデータ ソースを検索するには、-DPMServerNameパラメーターで検索文字列を指定します。
• DPMサーバー上の非アクティブなすべてのデータ ソースを返すには、-Inactiveパラメーターを使用します。非アクティブなデータ ソースとは、DPMサーバー上でアクティブに保護されていないデータ ソースです。
• 保護グループのデータ ソースを返すには、-ProtectionGroupパラメーターを使用します。

■パラメーター

-Async <SwitchParameter>
このパラメーターにより、コマンドレットの非同期実行を指定することができます。これは、完了に時間がかかるコマンドレットで使用すると便利です。操作の開始直後に制御がユーザーに返されます。また、操作の進捗状況が定期的にユーザーに通知されます。これは、コマンドレットを使用した GUI の構築時に役立ちます。ただし、DPM管理シェルの操作時には使用されません。

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

-ComputerName <String[]>
保護グループに追加するクライアント コンピューターの一覧。

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

-DPMServerName <String>
DPMサーバーの名前。

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

-GetVolumesWithoutMountPoints <SwitchParameter>
マウント ポイントを持たないボリュームも取得することを示します。

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

-IgnoreDPMInformation <SwitchParameter>
コマンドレットでデータ ソースの保護コンピューター情報を取得しないことを示します。

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

-Inactive <SwitchParameter>
DPMサーバー上の非アクティブ データ ソースを返します。非アクティブ データ ソースとは、以前は保護されていたが、現在は保護されていないデータ ソースです。非アクティブ データ ソースのレプリカおよび回復ポイントは、引き続き利用することができます。

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

-Inquire <SwitchParameter>
保護されたコンピューターを照会し、コンピューター上のデータ ソースまたは子データ ソースの一覧を返します。

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

-Path <String>
データ ソースを検索するパス。

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

-ProductionServer <ProductionServer>
DPMエージェントがインストールされているサーバー。

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

-ProductionServerName <String>
保護されているサーバーの名前。

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

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

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

-Replica <SwitchParameter>
セカンダリDPMサーバー上のレプリカに必要な領域を、保護されたコンピューターまたはプライマリ DPM サーバーから計算する必要があるかどうかを指定できます。

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

-Tag [<object>]
コマンドレットによって実行される各非同期呼び出しの応答を識別するのに役立ちます。これは、コマンドレットを使用した GUI の構築時に役立ちます。ただし、DPM管理シェルの操作時には使用されません。

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

<CommonParameters>
このコマンドレットは、次の共通パラメーターをサポートします: Verbose、Debug、ErrorAction、ErrorVariable、WarningAction、WarningVariable、OutBuffer、およびOutVariable。詳細については、「get-help about_commonparameters」と入力してヘルプを参照してください。

■入力

 

■出力

Datasource

■メモ

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

■例

例1

$ps = Get-ProductionServer -DPMServerName "TestingServer"
Get-DPMDatasource -ProductionServer $ps[1] -Inquire

このコマンドにより、コンピューター上にあるすべてのデータ ソースの一覧が返されます。

例2

$pg = Get-ProtectionGroup -DPMServerName "TestingServer"
Get-DPMDatasource -ProtectionGroup $pg

このコマンドにより、指定した保護グループで保護されたデータ ソースが取得されます。

例3

Get-DPMDatasource -DPMServerName "TestingServer" -Inactive

このコマンドにより、サーバー上の非アクティブ データ ソースが取得されます。

例4

Get-DPMDatasource -DPMServerName "TestingServer" -Path "F:" -ProductionServer "test.contoso.com"

このコマンドにより、指定した検索場所からデータ ソースが取得されます。

[参考]

• DPM Cmdlet Help – System Center 2012 Data Protection Manager
  http://technet.microsoft.com/en-us/library/hh881679.aspx
• Get-DPMDatasource – System Center 2012 Data Protection Manager
  http://technet.microsoft.com/en-us/library/hh881605.aspx
• DPM 2010のDPM管理シェルで使用できるコマンドレット (Get-Datasource) について « 焦げlog
  https://kogelog.com/2011/09/03/20110903-01/