Get-Job

Get-Job [-Command <string[]>] [<CommonParameters>]

Get-Job [[-InstanceId] <Guid[]>] [<CommonParameters>]

Get-Job [[-Name] <string[]>] [<CommonParameters>]

Get-Job [[-Id] <Int32[]>] [<CommonParameters>]

Get-Job [-State {<NotStarted> | <Running> | <Completed> | <Failed> | <Stopped> | <Blocked>}] [<CommonParameters>]

C:\PS>get-job

説明
-----------
このコマンドは、現在のセッションで開始されたすべてのバックグラウンド ジョブを取得します。ジョブがローカル コンピューターで実行されている場合も含め、他のセッションで作成されたジョブは含まれません。

C:\PS>$j = get-job -name Job1

C:\PS> $ID = $j.InstanceID

C:\PS> $ID

Guid
----
03c3232e-1d23-453b-a6f4-ed73c9e29d55

C:\PS> stop-job -instanceid $ID

説明
-----------
これらのコマンドは、ジョブのインスタンス ID を取得し、それを使用してジョブを停止する方法を示しています。ジョブ名は一意ではありませんが、インスタンス ID は一意です。

最初のコマンドは、Get-Job コマンドレットを使用してジョブを取得します。ジョブは Name パラメーターを使用して識別しています。Get-Job によって返されるジョブ オブジェクトは、$j 変数に保存されます。この例では、指定された名前のジョブは 1 つしかありません。

2 番目のコマンドは、$j 変数に保存されているオブジェクトの InstanceId プロパティを取得して、$ID 変数に保存します。

3 番目のコマンドは、$ID 変数の値を表示します。

4 番目のコマンドは、Stop-Job コマンドレットを使用してジョブを終了します。InstanceId パラメーターを使用してジョブを識別し、$ID 変数を使用してジョブのインスタンス ID を表します。

C:\PS>get-job -command "*get-process*"

説明
-----------
このコマンドは、システム上で Get-Process コマンドを含むジョブを取得します。このコマンドは、Get-Job の Command パラメーターを使用して、取得されるジョブを制限します。また、ワイルドカード文字 (*) を使用して、コマンド文字列に Get-Process コマンドを含むジョブを取得します。

C:\PS>"*get-process*" | get-job

説明
-----------
前の例のコマンドのように、このコマンドは、システム上で Get-Process コマンドを含むジョブを取得します。このコマンドは、パイプライン演算子 (|) を使用して、(二重引用符で囲まれた) 文字列を Get-Job コマンドレットに送ります。前のコマンドと同等です。

C:\PS>get-job -state NotStarted

説明
-----------
このコマンドは、作成されただけで開始されていないジョブのみを取得します。これには、今後の実行がスケジュールされているジョブとスケジュールされていないジョブが含まれます。

C:\PS>get-job -name job*

説明
-----------
このコマンドは、名前が "job" で始まるジョブをすべて取得します。"job<番号>" がジョブの既定の名前であるため、このコマンドは名前が明示的に割り当てられていないジョブをすべて取得します。

C:\PS>start-job -scriptblock {get-process} -name MyJob

C:\PS> $j = get-job -name MyJob

C:\PS> $j

Id       Name      State      HasMoreData     Location    Command
--       ----      -----      -----------     --------    -------
1        myjob     Completed  True            localhost   get-process

C:\PS> receive-job -job $j

Handles  NPM(K)    PM(K)      WS(K) VM(M)   CPU(s)     Id ProcessName
-------  ------    -----      ----- -----   ------     -- -----------
    124       4    13572      12080    59            1140 audiodg
    783      16    11428      13636   100             548 CcmExec
     96       4     4252       3764    59            3856 ccmsetup
...

説明
-----------
この例は、Get-Job を使用してジョブ オブジェクトを取得する方法を示し、次にそのジョブ オブジェクトを使用してコマンドのジョブを表す方法を示しています。

最初のコマンドは Start-Job コマンドレットを使用して、ローカル コンピューター上で Get-Process コマンドを実行するバックグラウンド ジョブを開始します。このコマンドは、Start-Job の Name パラメーターを使用して、ジョブにフレンドリ名を割り当てます。

2 番目のコマンドは、Get-Job を使用してジョブを取得します。Get-Job の Name パラメーターを使用してジョブを識別しています。このコマンドは、結果のジョブ オブジェクトを $j 変数に保存します。

3 番目のコマンドは、$j 変数のジョブ オブジェクトの値を表示します。State プロパティの値は、ジョブが完了したことを示しています。HasMoreData プロパティの値は、ジョブに、取得されていない利用可能な結果があることを示しています。

4 番目のコマンドは、Receive-Job コマンドレットを使用してジョブの結果を取得します。$j 変数のジョブ オブジェクトを使用してジョブを表します。パイプライン演算子を使用して、ジョブ オブジェクトを Receive-Job に送信することもできます。

C:\PS>start-job -scriptblock {get-eventlog system}

C:\PS> invoke-command -computername S1 -scriptblock {get-eventlog system} -AsJob

C:\PS> invoke-command -computername S2 -scriptblock {start-job -scriptblock {get-eventlog system}}

C:\PS> get-job

Id    Name     State      HasMoreData   Location   Command
--    ----     -----      -----------   --------   -------
1     Job1     Running    True          localhost  get-eventlog system
2     Job2     Running    True          S1         get-eventlog system

C:\PS> invoke-command -computername S2 -scriptblock {get-job}

Id    Name     State      HasMoreData   Location   Command
--    ----     -----      -----------   --------   -------
4     Job4     Running    True          localhost  get-eventlog system

説明
-----------
この例は、異なるメソッドを使用して開始されたジョブも含め、Get-Job コマンドレットが現在のセッションで開始されたすべてのジョブを取得できることを示しています。

最初のコマンドは、Start-Job コマンドレットを使用して、ジョブをローカル コンピューター上で開始します。

2 番目のコマンドは、Invoke-Command の AsJob パラメーターを使用して、ジョブを S1 コンピューター上で開始します。ジョブのコマンドがリモート コンピューターで実行されていても、ジョブ オブジェクトはローカル コンピューターで作成されるため、ローカル コマンドを使用してジョブを管理します。

3 番目のコマンドは、Invoke-Command コマンドレットを使用して、S2 コンピューターで Start-Job コマンドを実行します。このメソッドでは、リモート コンピューター上にジョブ オブジェクトが作成されるため、リモート コマンドを使用してジョブを管理します。

4 番目のコマンドは、Get-Job を使用してローカル コンピューターに保存されたジョブを取得します。

5 番目のコマンドは、Invoke-Command を使用して S2 コンピューターで Get-Job コマンドを実行します。

サンプル出力は、Get-Job コマンドの結果を示しています。

リモート コンピューターでのバックグラウンド ジョブの実行については、「about_Remote_Jobs」を参照してください。

C:\PS>start-job -scriptblock {get-process}

Id       Name            State      HasMoreData     Location             Command
--       ----            -----      -----------     --------             -------
1        Job1            Failed     False           localhost            get-process

C:\PS> (get-job).jobstateinfo | format-list -property *

State  : Failed
Reason :


C:\PS> get-job | format-list *

HasMoreData   : False
StatusMessage :
Location      : localhost
Command       : get-process
JobStateInfo  : Failed
Finished      : System.Threading.ManualResetEvent
InstanceId    : fb792295-1318-4f5d-8ac8-8a89c5261507
Id            : 1
Name          : Job1
ChildJobs     : {Job2}
Output        : {}
Error         : {}
Progress      : {}
Verbose       : {}
Debug         : {}
Warning       : {}
StateChanged  :


C:\PS> (get-job -name job2).jobstateinfo.reason
Connecting to remote server using WSManCreateShellEx api failed. The async callback gave the following error message :
Access is denied.

説明
-----------
このコマンドは、Get-Job が返すジョブ オブジェクトを使用して、ジョブが失敗した理由を調査する方法を示しています。各ジョブの子ジョブを取得する方法も示します。

最初のコマンドは、Start-Job コマンドレットを使用して、ジョブをローカル コンピューター上で開始します。Start-Job が返すジョブ オブジェクトは、ジョブが失敗したことを示しています。State プロパティの値は "Failed" です。

2 番目のコマンドは、Get-Job を使用してジョブ オブジェクトを取得します。このコマンドはドット メソッドを使用して、オブジェクトの JobStateInfo プロパティの値を取得します。パイプライン演算子を使用して、JobStateInfo プロパティのオブジェクトが Format-List コマンドレットに送信され、一覧にあるオブジェクトのすべてのプロパティ (*) が書式設定されます。

Format-List コマンドの結果は、ジョブの Reason プロパティの値が空白であることを示しています。

3 番目のコマンドは、さらに調査を行います。Get-Job コマンドを使用してジョブを取得し、パイプライン演算子を使用してジョブ オブジェクト全体を Format-List コマンドレットに送信し、これにより一覧にあるジョブのプロパティがすべて表示されます。

ジョブ オブジェクトのすべてのプロパティの表示により、ジョブに "Job2" という名前の子ジョブが含まれることが示されています。

4 番目のコマンドは、Get-Job を使用して子ジョブ Job2 を表すジョブ オブジェクトを取得します。これは、コマンドが実際に実行されたジョブです。このコマンドはドット メソッドを使用して、JobStateInfo プロパティの Reason プロパティを取得します。

結果は、"access denied" エラーが原因でジョブが失敗したことを示しています。この例では、ユーザーが Windows PowerShell の起動時に [管理者として実行] を使用しなかったと想定しています。

バックグラウンド ジョブは Windows PowerShell のリモート処理機能を使用するため、ジョブがローカル コンピューターで実行される場合でも、ジョブを実行するにはコンピューターがリモート処理用に構成されている必要があります。

Windows PowerShell のリモート処理の要件については、「about_Remote_Requirements」を参照してください。トラブルシューティングのヒントについては、「about_Remote_Troubleshooting」を参照してください。