Start-Job

Start-Job [-ScriptBlock] <scriptblock> [[-InitializationScript] <scriptblock>] [-ArgumentList <Object[]>] [-Authentication {<Default> | <Basic> | <Negotiate> | <NegotiateWithImplicitCredential> | <Credssp> | <Digest> | <Kerberos>}] [-Credential <PSCredential>] [-InputObject <psobject>] [-Name <string>] [-RunAs32] [<CommonParameters>]

Start-Job [[-FilePath] <string>] [[-InitializationScript] <scriptblock>] [-ArgumentList <Object[]>] [-Authentication {<Default> | <Basic> | <Negotiate> | <NegotiateWithImplicitCredential> | <Credssp> | <Digest> | <Kerberos>}] [-Credential <PSCredential>] [-InputObject <psobject>] [-Name <string>] [-RunAs32] [<CommonParameters>]

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

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

Id    Name  State    HasMoreData  Location   Command
---   ----  -----    -----------  --------   -------
1     Job1  Running  True         localhost  get-process

説明
-----------
このコマンドは、Get-Process コマンドを実行するバックグラウンド ジョブを開始します。コマンドは、ジョブに関する情報を含むジョブ オブジェクトを返します。すぐにコマンド プロンプトに戻るため、バックグラウンドでジョブが実行されている間もセッションで作業できます。

C:\PS>$jobWRM = invoke-command -computerName (get-content servers.txt) -scriptblock {get-service winrm} -jobname WinRM -throttlelimit 16 -AsJob

説明
-----------
このコマンドは、Invoke-Command コマンドレットとその AsJob パラメーターを使用して、"get-service winrm" コマンドを実行するバックグラウンド ジョブを多数のコンピューター上で開始します。コマンドの実行により大量のネットワーク トラフィックがサーバーに発生するため、Invoke-Command の ThrottleLimit パラメーターを使用して同時に実行されるコマンドの数を 16 個に制限しています。

コマンドは、ComputerName パラメーターを使用して、ジョブを実行するコンピューターを指定します。ComputerName パラメーターの値は、Servers.txt ファイルのテキストを取得する Get-Content コマンドです。このファイルには、ドメイン内のコンピューター名が含まれています。

ScriptBlock パラメーターを使用してコマンドを指定し、JobName パラメーターを使用してジョブのフレンドリ名を指定します。

C:\PS>$j = start-job -scriptblock {get-eventlog -log system} -credential domain01\user01

C:\PS> $j | format-list -property *

HasMoreData   : True
StatusMessage :
Location      : localhost
Command       : get-eventlog -log system
JobStateInfo  : Running
Finished      : System.Threading.ManualResetEvent
InstanceId    : 2d9d775f-63e0-4d48-b4bc-c05d0e177f34
Id            : 1
Name          : Job1
ChildJobs     : {Job2}
Output        : {}
Error         : {}
Progress      : {}
Verbose       : {}
Debug         : {}
Warning       : {}
StateChanged  :

C:\PS> $j.JobStateInfo.state
Completed

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

C:\PS> $results
Index Time          Type        Source                EventID Message
----- ----          ----        ------                ------- -------
84366 Feb 18 19:20  Information Service Control M...     7036 The description...
84365 Feb 18 19:16  Information Service Control M...     7036 The description...
84364 Feb 18 19:10  Information Service Control M...     7036 The description...
...

説明
-----------
これらのコマンドは、イベント ビューアーのシステム ログからすべてのイベントを取得するバックグラウンド ジョブを管理します。ジョブは、ローカル コンピューター上で実行されます。

最初のコマンドは、Start-Job コマンドレットを使用してジョブを開始します。Credential パラメーターを使用して、コンピューター上でジョブを実行するアクセス許可を持つユーザーのユーザー アカウントを指定します。Start-Job によって返されるジョブ オブジェクトは、$j 変数に保存されます。

この時点で、ジョブの完了を待たずに別の作業を再開できます。

2 番目のコマンドは、パイプライン演算子 (|) を使用して、$j に保存されたジョブ オブジェクトを Format-List コマンドレットに渡します。Format-List コマンドは Property パラメーターにすべての値 (*) を指定して、ジョブ オブジェクトのすべてのプロパティを一覧に表示します。

3 番目のコマンドは、JobStateInfo プロパティの値を表示します。これには、ジョブの状態が含まれます。

4 番目のコマンドは、Receive-Job コマンドレットを使用してジョブの結果を取得します。結果は $results 変数に保存されます。

最後のコマンドは、$results 変数の内容を表示します。

C:\PS>start-job -filepath c:\scripts\sample.ps1

説明
-----------
このコマンドは、Sample.ps1 スクリプトをバックグラウンド ジョブとして実行します。

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

説明
-----------
このコマンドは、ローカル コンピューター上で WinRM プロセスを取得するバックグラウンド ジョブを実行します。このコマンドは、ScriptBlock パラメーターを使用して、バックグラウンド ジョブで実行するコマンドを指定します。また、Name パラメーターを使用して、新しいジョブのフレンドリ名を指定します。

C:\PS>start-job -name GetMappingFiles -initializationScript {import-module MapFunctions} -scriptblock {Get-Map -name * | set-content D:\Maps.tif} -runAs32

説明
-----------
このコマンドは、大量のデータを収集して .tif ファイルに保存するジョブを開始します。このコマンドは、InitializationScript パラメーターを使用して、必要なモジュールをインポートするスクリプト ブロックを実行します。また、RunAs32 パラメーターを使用して、コンピューターが 64 ビット オペレーティング システムを実行している場合でもジョブを 32 ビット プロセスで実行します。