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

ブログ エントリ内にアフィリエイト広告が含まれています

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

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

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

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

■名前

Stop-DedupJob

■概要

1 つ以上の指定したデータ重複除去ジョブをキャンセルします。

■構文

Stop-DedupJob [-Volume] <String[]> [[-Type] <Type[]>] [-AsJob] [-CimSession <CimSession[]>] [-PassThru] [-ThrottleLimit <Int32>] [<CommonParameters>] Stop-DedupJob [-AsJob] [-CimSession <CimSession[]>] [-Id <String[]>] [-PassThru] [-ThrottleLimit <Int32>] [<CommonParameters>]

Stop-DedupJob [-AsJob] [-CimSession <CimSession[]>] [-PassThru] [-ThrottleLimit <Int32>] -InputObject <CimInstance[]> [<CommonParameters>]

■説明

Stop-DedupJob コマンドレットは、1 つ以上の指定したデータ重複除去ジョブをキャンセルします。

このコマンドレットを実行するには、[管理者として実行] オプションを用いて Windows PowerShell を開始する必要があります。

■パラメーター

-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

-Id <String[]>
キャンセルするジョブ ID を指定します。これは、Get-DedupJob コマンドレットの実行によって取得することが可能です。

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

-InputObject <CimInstance[]>
変更されるインスタンスを表す CIM インスタンス オブジェクトを指定します。オブジェクトを含む変数、コマンドレット形式、もしくは Get-DedupVolume コマンドレットのようなオブジェクトを取得する式を入力します。サービス オブジェクトは Set-DedupVolume コマンドレットへパイプすることが可能です。

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

-PassThru [<SwitchParameter>]
停止したいオブジェクトを表すデータ重複除去設定を返し、次のコマンドレットにパイプラインを介してプッシュします。

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

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

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

-Type <Type[]>
DeduplicationJobSchedule オブジェクトを返すために、1 つ以上のデータ重複除去ジョブ スケジュール名を指定します。このパラメーターに対する利用可能な値は以下のとおりです。

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

-Volume <String[]>
1 つ以上のデータ重複除去ジョブ名をキャンセルするために、 1 つ以上のファイル システム ボリュームの配列を指定します。(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 オブジェクトの名前空間とクラス名を提供します。
  • Microsoft.PowerShell.Cmdletization.GeneratedTypes.DedupJob.Type[]

■出力

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

■メモ

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

■エイリアス

  • なし

■例

例 1: 指定したボリューム上のジョブを停止する。

 Stop-DedupJob -Volume "D:"

このコマンドは、D: ボリューム上のデータ重複除去ジョブを停止します。

■関連するトピック

  • Get-DedupJob
  • Start-DedupJob

[参考]

タイトルとURLをコピーしました