Windows Server 2012 / 2012 R2 におけるデータ重複除去関連のコマンドレット (Disable-DedupVolume) について

スポンサーリンク

既定ではインストールされていませんが、Windows Server 2012 / 2012 R2 標準の機能としてデータ重複除去というデータの重複を検出し、そのデータの正確さや整合性を損なうことなく削除する機能や PowerShell コマンドレットなどの関連ツールを提供しています。

データ重複除去関連の PowerShell コマンドレットのヘルプに関しては英語のみとなっており、日本語による情報はあまり公開されていません。

ここでは、データ重複除去 に関する PowerShell コマンドレットの 1 つである「Disable-DedupVolume」について、日本語の情報として纏めてみました ((他の PowerShell コマンドレットについては、「Windows Server 2012 / 2012 R2 におけるデータ重複除去関連のコマンドレットについて」を参照)。

※Windows Server 2012 / 2012 R2 と比較した際、内容の相違がほとんどないことから、Windows Server 2012 R2 (内容については「Get-Help」コマンドレットの -Full オプションを用いて実行した結果を編集したものとなります) の情報を元に編集、意訳したものとなります。

■名前

Disable-DedupVolume

■概要

1 つ以上のボリューム上のデータ重複除去アクティビティを無効にします。

■構文

Disable-DedupVolume [-Volume] <String[]> [-AsJob] [-CimSession <CimSession[]>] [-DataAccess] [-ThrottleLimit <Int32>] [<CommonParameters>]

■説明

Disable-DedupVolume コマンドレットは、1 つ以上のボリューム上のデータ重複除去を無効にします。データ重複除去を無効後、ボリュームが重複除去された状態のままであり、既存の重複除去されたデータはアクセス可能です。サーバーはボリュームのデータ重複除去ジョブの実行を停止し、新しいデータは重複除去されません。ボリューム上のデータ重複除去を元に戻すには、Start-DedupJob コマンドレットを使用し、Type パラメータに Unoptimization を指定します。

ボリューム上のデータ重複除去を無効にした後、ボリューム上のすべての読み取り専用重複除去コマンドレットの操作を行うことが可能です。たとえば、データ重複除去メタデータを持つボリュームの重複除去ステータスを取得するには、Get-DedupStatus コマンドレットを使用することが可能です。ボリューム上のデータ重複除去を無効にした後、ボリューム上で操作を実行するために、データ重複除去ジョブ関連のコマンドレット、および Update-DedupStatus コマンドレットを使用することはできません。たとえば、無効化されたデータ重複除去機能を持っているボリュームのデータ重複除去ジョブを開始するには、Start-DedupJob コマンドレットを使用することはできません。

■パラメーター

-AsJob [<SwitchParameter>]
バックグラウンド ジョブとしてコマンドレットを実行します。完了するまでに長い時間がかかるコマンドを実行するには、このパラメーターを使用します。コマンドレットは、即座にジョブを表すオブジェクトを返し、コマンドプロンプトに表示します。ジョブが完了する間のセッション上で作業を続けることが可能です。ジョブを管理するために、*-Job コマンドレットを使用します。ジョブの結果を取得するために、 Receive-Job コマンドレットを使用します。Windows PowerShell バックグラウンド ジョブに関する詳細な情報は、about_Jobs を参照してください。

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

-CimSession <CimSession[]>
リモート セッション、もしくはリモート コンピューターでコマンドレットを実行します。New-CimSession コマンドレット、もしくは Get-CimSession コマンドレットの出力として、コンピューター名、もしくはセッション オブジェクトを入力します。既定では、ローカル コンピューター上の現在のセッションです。

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

-DataAccess [<SwitchParameter>]
ボリューム上の重複除去されたファイルへのデータ アクセスが無効になっていることを示します。

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

-ThrottleLimit <Int32>
コマンドレットを実行するために確立できる同時操作の最大数を指定します。このパラメーターが省略、もしくは値 0 が入力された場合、Windows PowerShell は、コンピュータ上で実行されている CIM コマンドレットの数に基づいて、コマンドレットのための最適なスロットル限界を計算します。スロットル限界は、セッションもしくはコンピューターではなく、現在のコマンドレットのみ適用されます。

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

-Volume <String[]>
データ重複除去を無効にするためのシステム ボリュームの配列を指定します。(D: のような) ドライブ レター、もしくは (フォーム「\?Volume{{GUID}}」を用いて) GUID パラメーターとして、1 つ以上のボリューム ID を指定します。カンマで複数のボリュームを区切ります。

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

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

■入力

  • System.String[]

■出力

  • Microsoft.Management.Infrastructure.CimInstance#
    Microsoft.Management.Infrastructure.CimInstance オブジェクトは、Windows Management Instrumentation (WMI) オブジェクトを表示するラッパー クラスです。シャープ記号 (#) 以降のパスは、基礎となる WMI オブジェクトの名前空間とクラス名を提供します。

■メモ

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

■エイリアス

  • なし

■例

例 1: ボリューム上のデータ重複除去を無効にする。

 Disable-DedupVolume -Volume D:,E:,F:,G: 

このコマンドは、ボリューム D:、E:、F:、および G: に対してデータ 重複除去を無効にします。

例 2: GUID を用いてボリューム上のデータ重複除去を無効にする。

 Disable-DedupVolume –Volume \\?\Volume{26a21bda-a627-11d7-9931-806e6f6e6963}\ 

このコマンドは、GUID「26a21bda-a627-11d7-9931-806e6f6e6963」を持つボリュームに対してデータ重複除去を無効にします。

例 3: 指定したボリュームに対して IO アクティビティを一時停止する。

 Disable-DedupVolume -Volume X: -DataAccess 

このコマンドは、指定したボリューム上のデータ重複除去に対して IO アクティビティを一時停止します。事実上、このコマンドは指定したボリュームから切り離すために、データ重複除去ファイル システム ミニフィルタの要因となります。このコマンドの完了後、データ重複除去ファイルへの IO が Enable-DedupVolume -DataAccess コマンドレットの実行、または再起動のどちらかを実施するまで ERROR_INVALID_FUNCTION エラーで失敗します。

■関連するトピック

  • Enable-DedupVolume
  • Get-DedupVolume
  • Set-DedupVolume
  • Update-DedupStatus

[参考]