System Center 2016 – Data Protection Manager (DPM 2016) の DPM 管理シェルは、PowerShell を用いたコマンドライン インタフェースです。
DPM 管理シェルは、デスクトップ上のアイコン、もしくは [スタート メニュー] – [Microsoft System Center 2016] – [DPM 管理シェル] を選択、クリックすることで起動することが可能です。
DPM 2016 の管理を目的として様々なコマンドレットが DPM 管理シェルに用意されていますが、 コマンドレットのヘルプについては、日本語の情報は公開されていません。
このヘルプ情報について、「Get-Help」コマンドレットの -Full オプションを用いて実行した結果を編集、意訳しました。
この記事では、「New-DPMSearchOption」コマンドレットについて記載します (他のコマンドレットについては、「System Center 2016 – Data Protection Manager の DPM 管理シェルで使用できるコマンドレットについて」を参照)。
New-DPMSearchOption コマンドレット
名前
New-DPMSearchOption
エイリアス
New-SearchOption
概要
回復可能なオブジェクトの検索オプションを指定するオブジェクトを作成します。
構文
| New-DPMSearchOption [-FromRecoveryPoint] <DateTime> [-ToRecoveryPoint] <DateTime> [-SearchDetail] {FilesFolders | MailboxByAlias | MailboxByDisplayName | WssSite | WssDocuments | ClientVolumes} [-SearchType] {startsWith | contains | endsWith | exactMatch} [-SearchString] <String> [-Location <String>] [-Recursive] [<CommonParameters>] |
説明
New-DPMSearchOption コマンドレットは、System Center 2016 – Data Protection Manager (DPM) が管理する回復可能なオブジェクトの検索オプションを指定したオブジェクトを作成します。検索文字列や、検索するリカバリポイントの範囲、検索するオブジェクトの種類、および場所と再帰的に検索するかどうかを指定できます。
検索を実行するには、Get-DPMRecoverableItem コマンドレットを用います。
パラメーター
-FromRecoveryPoint <DateTime>
日時オブジェクトを指定します。これは検索範囲の最初の日付です。
| 必須 | true |
| 位置 | 1 |
| 既定値 | なし |
| パイプライン入力を許可する | false |
| ワイルドカード文字を許可する | false |
-Location [<String>]
回復ポイントの場所を指定します。
| 必須 | false |
| 位置 | named |
| 既定値 | なし |
| パイプライン入力を許可する | false |
| ワイルドカード文字を許可する | false |
-Recursive [<SwitchParameter>]
検索を再帰的に行う場合に指定します。
| 必須 | false |
| 位置 | named |
| 既定値 | なし |
| パイプライン入力を許可する | false |
| ワイルドカード文字を許可する | false |
-SearchDetail <SearchParameters+SearchForDetail>
検索するオブジェクトの種類を検索します。
このパラメーターで利用可能な値 :
- FileFolders
- MailboxByAlias
- MailboxByDisplayName
- WssSite
- WssDocuments
| 必須 | true |
| 位置 | 3 |
| 既定値 | なし |
| パイプライン入力を許可する | false |
| ワイルドカード文字を許可する | false |
-SearchString <String>
ターゲット回復ポイントの検索文字列を指定します。
| 必須 | true |
| 位置 | 5 |
| 既定値 | なし |
| パイプライン入力を許可する | false |
| ワイルドカード文字を許可する | false |
-SearchType <SearchParameters+SearchFilterType>
検索を行う際の比較の種類を指定します。
このパラメーターで利用可能な値 :
- startsWith
- contains
- endsWith
- exactMatch
| 必須 | true |
| 位置 | 4 |
| 既定値 | なし |
| パイプライン入力を許可する | false |
| ワイルドカード文字を許可する | false |
-ToRecoveryPoint <DateTime>
日時オブジェクトを指定します。これは検索範囲における終点の日付です。
| 必須 | true |
| 位置 | 2 |
| 既定値 | なし |
| パイプライン入力を許可する | false |
| ワイルドカード文字を許可する | false |
<CommonParameters>
このコマンドレットは、次の共通パラメーターをサポートします: -Verbose、-Debug、-ErrorAction、-ErrorVariable、-WarningAction、-WarningVariable、-OutBuffer、-PipelineVariable、および -OutVariable。詳細については、about_CommonParameters を参照してください。
入力
入力の種類は、コマンドレットにパイプ可能なオブジェクトの種類です。
出力
出力の種類は、コマンドレットが発行するオブジェクトの種類です。
- SearchOption
例
例 1 : 検索オプションを作成する
New-DPMSearchOption -FromRecoveryPoint "15 September 2009" -ToRecoveryPoint "28 September 2009" -SearchDetail FileFolders -SearchType contains -Recursive -SearchString "tobe" -Location "D:\"
このコマンドは、September 15, 2009 から September 28, 2009 の間で回復ポイントの検索オプション オブジェクトを作成します。このオブジェクトは、D:\ にある文字列を含むファイルおよびフォルダーの検索を指定します。このコマンドは、再帰的に検索を指定します。したがって、検索では D:\ ドライブのフォルダー内のファイルおよびフォルダーもチェックされます。
関連するリンク
- Get-DPMRecoverableItem
- Data Protection Manager コマンドレット
参考
- Data Protection Manager Cmdlets
https://technet.microsoft.com/en-us/library/hh881730(v=sc.30).aspx - New-DPMSearchOption
https://technet.microsoft.com/en-us/library/hh881728(v=sc.30).aspx