共用方式為


Start-Job

啟動PowerShell背景作業。

Syntax

Start-Job
     [-Name <String>]
     [-ScriptBlock] <ScriptBlock>
     [-Credential <PSCredential>]
     [-Authentication <AuthenticationMechanism>]
     [[-InitializationScript] <ScriptBlock>]
     [-RunAs32]
     [-PSVersion <Version>]
     [-InputObject <PSObject>]
     [-ArgumentList <Object[]>]
     [<CommonParameters>]
Start-Job
     [-DefinitionName] <String>
     [[-DefinitionPath] <String>]
     [[-Type] <String>]
     [<CommonParameters>]
Start-Job
     [-Name <String>]
     [-Credential <PSCredential>]
     [-FilePath] <String>
     [-Authentication <AuthenticationMechanism>]
     [[-InitializationScript] <ScriptBlock>]
     [-RunAs32]
     [-PSVersion <Version>]
     [-InputObject <PSObject>]
     [-ArgumentList <Object[]>]
     [<CommonParameters>]
Start-Job
     [-Name <String>]
     [-Credential <PSCredential>]
     -LiteralPath <String>
     [-Authentication <AuthenticationMechanism>]
     [[-InitializationScript] <ScriptBlock>]
     [-RunAs32]
     [-PSVersion <Version>]
     [-InputObject <PSObject>]
     [-ArgumentList <Object[]>]
     [<CommonParameters>]
Start-Job
     [-VMGuid] <Guid[]>
     [<CommonParameters>]
Start-Job
     [-VMGuid] <Guid[]>
     [<CommonParameters>]
Start-Job
     -VMName <String[]>
     [<CommonParameters>]
Start-Job
     -VMName <String[]>
     [<CommonParameters>]

Description

Cmdlet 會在 Start-Job 本機計算機上啟動 PowerShell 背景工作。

PowerShell 背景作業會執行命令,而不需與目前的會話互動。 當您啟動背景作業時,即使作業需要很久才完成,也會立即傳回作業物件。 工作執行時,您可以在工作階段中繼續工作,而不需中斷。

作業物件包含作業的實用資訊,但不包含作業結果。 當作業完成時,請使用 Receive-Job Cmdlet 來取得作業的結果。 如需背景工作的詳細資訊,請參閱 about_Jobs

若要在遠端電腦上執行背景工作,請使用許多 Cmdlet 上可用的 AsJob 參數,或使用 Invoke-Command Cmdlet 在遠端電腦上執行 Start-Job 命令。 如需詳細資訊,請參閱 about_Remote_Jobs

從 PowerShell 3.0 開始, Start-Job 可以啟動自定義作業類型的實例,例如排程的工作。 如需如何使用 Start-Job 來啟動具有自定義類型之作業的資訊,請參閱作業類型功能的說明檔。

範例

範例 1:啟動背景工作

此範例會啟動在本機計算機上背景中執行的作業。

Start-Job -ScriptBlock {Get-Process}

Id  Name   PSJobTypeName   State     HasMoreData   Location    Command
--  ----   -------------   -----     -----------   --------    -------
1   Job1   BackgroundJob   Running   True          localhost   Get-Process

Start-Job 會使用 ScriptBlock 參數以背景作業的形式執行 Get-Process 。 作業資訊隨即顯示,且PowerShell會在工作在背景執行時返回提示。

範例 2:使用 Invoke-Command 啟動作業

此範例會在多部計算機上執行作業。 作業會儲存在變數中,並使用PowerShell命令行上的變數名稱來執行。

$jobWRM = Invoke-Command -ComputerName (Get-Content -Path C:\Servers.txt) -ScriptBlock {
   Get-Service -Name WinRM } -JobName WinRM -ThrottleLimit 16 -AsJob

使用的 Invoke-Command 作業會建立並儲存在變數中 $jobWRMInvoke-Command 會使用 ComputerName 參數來指定作業執行所在的電腦。 Get-Content 會從 C:\Servers.txt 檔案取得伺服器名稱。

ScriptBlock 參數會指定取得 WinRM 服務的命令Get-ServiceJobName 參數會指定作業的易記名稱 WinRMThrottleLimit 參數會將並行命令數目限制為 16。 AsJob 參數會啟動在伺服器上執行命令的背景作業。

範例 3:取得作業資訊

本範例會取得作業的相關信息,並顯示本機計算機上執行之已完成工作的結果。

$j = Start-Job -ScriptBlock { Get-WinEvent -Log System } -Credential Domain01\User01
$j | Select-Object -Property *

State         : Completed
HasMoreData   : True
StatusMessage :
Location      : localhost
Command       : Get-WinEvent -Log System
JobStateInfo  : Completed
Finished      : System.Threading.ManualResetEvent
InstanceId    : 27ce3fd9-40ed-488a-99e5-679cd91b9dd3
Id            : 18
Name          : Job18
ChildJobs     : {Job19}
PSBeginTime   : 8/8/2019 14:41:57
PSEndTime     : 8/8/2019 14:42:07
PSJobTypeName : BackgroundJob
Output        : {}
Error         : {}
Progress      : {}
Verbose       : {}
Debug         : {}
Warning       : {}
Information   : {}

Start-Job 會使用 ScriptBlock 參數來執行命令,指定 Get-WinEvent 取得 系統 記錄檔。 Credential 參數會指定具有在計算機上執行作業許可權的網域用戶帳戶。 作業物件會儲存在變數中 $j

變數中的 $j 物件會向下傳送至 Select-Object管線。 Property 參數會指定星號 () * 來顯示所有作業對象的屬性。

範例 4:以背景工作身分執行腳本

在此範例中,本機計算機上的腳本會以背景工作的形式執行。

Start-Job -FilePath C:\Scripts\Sample.ps1

Start-Job 會使用 FilePath 參數來指定儲存在本機電腦上的腳本檔案。

範例 5:使用背景工作取得進程

此範例會使用背景工作依名稱取得指定的進程。

Start-Job -Name PShellJob -ScriptBlock { Get-Process -Name PowerShell }

Start-Job 會使用 Name 參數來指定易記的作業名稱 PShellJobScriptBlock 參數會Get-Process指定以 PowerShell 名稱取得進程。

範例 6:使用背景工作收集和儲存數據

此範例會啟動收集大量地圖數據的作業,然後將它儲存在檔案中 .tif

Start-Job -Name GetMappingFiles -InitializationScript {Import-Module MapFunctions} -ScriptBlock {
   Get-Map -Name * | Set-Content -Path D:\Maps.tif } -RunAs32

Start-Job 會使用 Name 參數來指定易記的工作名稱 GetMappingFilesInitializationScript 參數會執行匯入 MapFunctions 模組的腳本區塊。 ScriptBlock 參數會執行Get-Map,並將Set-Content數據儲存在 Path 參數所指定的位置。 RunAs32 參數會以 32 位的形式執行進程,即使在 64 位作業系統上也一樣。

範例 7:將輸入傳遞至背景工作

這個範例會 $input 使用自動變數來處理輸入物件。 使用 Receive-Job 來檢視作業的輸出。

Start-Job -ScriptBlock { Get-Content $input } -InputObject "C:\Servers.txt"
Receive-Job -Name Job45 -Keep

Server01
Server02
Server03
Server04

Start-Job會使用 ScriptBlock 參數搭配自動變數執行Get-Content$input。 變數 $input 會從 InputObject 參數取得物件。 Receive-Job 會使用 Name 參數來指定作業並輸出結果。 Keep 參數會儲存作業輸出,以便在 PowerShell 工作階段期間再次檢視。

參數

-ArgumentList

針對 FilePath 參數所指定的腳本,指定自變數或參數值的陣列。

由於 ArgumentList 參數名稱後面的所有值都會解譯為 ArgumentList 的值,因此請將此參數指定為命令中的最後一個參數。

Type:Object[]
Aliases:Args
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Authentication

指定用來驗證使用者認證的機制。

此參數可接受的值如下所示:

  • Default
  • 基本資訊
  • Credssp
  • Digest
  • Kerberos
  • 交涉
  • NegotiateWithImplicitCredential

預設值為 Default。

CredSSP 驗證僅適用於 Windows Vista、Windows Server 2008 和更新版本的 Windows 操作系統。

如需此參數值的詳細資訊,請參閱 AuthenticationMechanism

警告

使用者認證會傳遞至要驗證之遠端電腦的「認證安全性支援提供者 (CredSSP)」驗證,是設計用於需要在一個以上資源進行驗證的命令,例如存取遠端網路共用。 此機制會使得遠端作業的安全性風險變高。 若遠端電腦遭到入侵,傳遞給它的認證便可用來控制網路工作階段。

Type:AuthenticationMechanism
Accepted values:Default, Basic, Negotiate, NegotiateWithImplicitCredential, Credssp, Digest, Kerberos
Position:Named
Default value:Default
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Credential

指定具有執行此動作權限的使用者帳戶。 如果未指定 Credential 參數,此命令會使用目前用戶的認證。

輸入用戶名稱,例如 User01Domain01\User01,或輸入 PSCredential 物件,例如 Cmdlet 中的 Get-Credential 一個。

Type:PSCredential
Position:Named
Default value:Current user
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefinitionName

指定此 Cmdlet 啟動之作業的定義名稱。 使用這個參數來啟動具有定義名稱的自訂工作類型,例如已排程的工作。

當您使用 Start-Job 來啟動排程工作的實例時,不論作業觸發程式或作業選項為何,作業都會立即啟動。 產生的作業實例是排程的工作,但不會像觸發的排程工作一樣儲存到磁碟。 您無法使用的 Start-JobArgumentList 參數,為在排程作業中執行的腳本參數提供值。 如需詳細資訊,請參閱 about_Scheduled_Jobs

此參數是在 PowerShell 3.0 中引進。

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-DefinitionPath

指定這個 Cmdlet 啟動之作業的定義路徑。 輸入定義路徑。 DefinitionPathDefinitionName 參數值的串連是作業定義的完整路徑。 使用這個參數來啟動具有定義路徑的自訂工作類型,例如已排程的工作。

針對排程的工作, DefinitionPath 參數的值是 $home\AppData\Local\Windows\PowerShell\ScheduledJob

此參數是在 PowerShell 3.0 中引進。

Type:String
Position:1
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FilePath

指定做為背景作業執行的本機腳本 Start-Job 。 輸入文稿的路徑和檔案名,或使用管線將文稿路徑傳送至 Start-Job。 腳本必須位於本機電腦或本機計算機可以存取的資料夾中。

當您使用此參數時,PowerShell 會將指定腳本檔案的內容轉換成腳本區塊,並以背景工作的形式執行腳本區塊。

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-InitializationScript

指定要在工作開始之前執行的命令。 若要建立腳本區塊,請將命令括在大括弧 ({}) 。

使用這個參數來準備執行工作的工作階段。 例如,您可以使用它來新增函式、嵌入式管理單元和模組到工作階段。

Type:ScriptBlock
Position:1
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

指定命令的輸入。 輸入包含物件的變數,或輸入可產生物件的命令或運算式。

ScriptBlock 參數的值中 $input ,使用自動變數來表示輸入物件。

Type:PSObject
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-LiteralPath

指定此 Cmdlet 以背景工作的形式執行的本機腳本。 輸入本機電腦上的腳本路徑。

Start-Job 會使用 LiteralPath 參數的值,完全符合其類型。 沒有字元會被視為萬用字元。 如果路徑包含逸出字元,請將它括在單引號中。 單引號會指示PowerShell不要將任何字元解譯為逸出序列。

Type:String
Aliases:PSPath
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Name

指定新工作的好記名稱。 您可以使用名稱來識別作業給其他作業 Cmdlet,例如 Stop-Job Cmdlet。

默認易記名稱為 Job#,其中 # 是每個作業遞增的序號。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-PSVersion

指定版本。 Start-Job 會使用 PowerShell 版本執行作業。 這個參數可接受的值為: 2.03.0

此參數是在 PowerShell 3.0 中引進。

Type:Version
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RunAs32

表示 Start-Job 在32位進程中執行作業。 RunAs32 會強制作業在 32 位進程中執行,即使在 64 位作業系統上也是如此。

在 64 位版本的 Windows 7 和 Windows Server 2008 R2 上,當命令包含 RunAs32 參數時Start-Job,您無法使用 Credential 參數來指定其他使用者的認證。

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ScriptBlock

指定要在背景工作執行的命令。 若要建立腳本區塊,請將命令括在大括弧 ({}) 。 $input使用自動變數來存取 InputObject 參數的值。 此為必要參數。

Type:ScriptBlock
Aliases:Command
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Type

指定 由 啟動 Start-Job之作業的自定義類型。 輸入自訂工作類型名稱,例如,已排程工作的 PSScheduledJob 或工作流程工作的 PSWorkflowJob。 此參數對標準背景工作無效。

此參數是在 PowerShell 3.0 中引進。

Type:String
Position:2
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

輸入

String

您可以使用管線,將具有 Name 屬性的物件傳送至 Name 參數。 例如,您可以將 FileInfo 物件從 Get-ChildItem 管線傳送至 Start-Job

輸出

System.Management.Automation.PSRemotingJob

Start-Job 會傳回 PSRemotingJob 物件,代表啟動的作業。

備註

若要在背景中執行, Start-Job 請在目前會話的自己的會話中執行。 當您使用 Invoke-Command Cmdlet 在遠端電腦上的工作階段中執行 Start-Job 命令時, Start-Job 請在遠端工作階段的作業階段中執行 。