Start-Job

Sözdizimi

Start-Job
     [-Name <String>]
     [-ScriptBlock] <ScriptBlock>
     [-Credential <PSCredential>]
     [-Authentication <AuthenticationMechanism>]
     [[-InitializationScript] <ScriptBlock>]
     [-WorkingDirectory <String>]
     [-RunAs32]
     [-PSVersion <Version>]
     [-InputObject <PSObject>]
     [-ArgumentList <Object[]>]
     [<CommonParameters>]

Start-Job
     [-DefinitionName] <String>
     [[-DefinitionPath] <String>]
     [[-Type] <String>]
     [-WorkingDirectory <String>]
     [<CommonParameters>]

Start-Job
     [-Name <String>]
     [-Credential <PSCredential>]
     [-FilePath] <String>
     [-Authentication <AuthenticationMechanism>]
     [[-InitializationScript] <ScriptBlock>]
     [-WorkingDirectory <String>]
     [-RunAs32]
     [-PSVersion <Version>]
     [-InputObject <PSObject>]
     [-ArgumentList <Object[]>]
     [<CommonParameters>]

Start-Job
     [-Name <String>]
     [-Credential <PSCredential>]
     -LiteralPath <String>
     [-Authentication <AuthenticationMechanism>]
     [[-InitializationScript] <ScriptBlock>]
     [-WorkingDirectory <String>]
     [-RunAs32]
     [-PSVersion <Version>]
     [-InputObject <PSObject>]
     [-ArgumentList <Object[]>]
     [<CommonParameters>]

Description

Start-Job Cmdlet, yerel bilgisayarda bir PowerShell arka plan işi başlatır.

PowerShell arka plan işi, geçerli oturumla etkileşim kurmadan bir komut çalıştırır. Bir arka plan işi başlattığınızda, işin tamamlanması uzun sürse bile iş nesnesi hemen geri döner. İş çalışırken oturumda kesintisiz olarak çalışmaya devam edebilirsiniz.

İş nesnesi iş hakkında yararlı bilgiler içerir, ancak iş sonuçlarını içermez. İş tamamlandığında, işin sonuçlarını almak için cmdlet'ini kullanın Receive-Job . Arka plan işleri hakkında daha fazla bilgi için bkz . about_Jobs.

Uzak bir bilgisayarda arka plan işi çalıştırmak için, birçok cmdlet'te kullanılabilen AsJob parametresini kullanın veya cmdlet'ini kullanarak Invoke-Command uzak bilgisayarda bir Start-Job komut çalıştırın. Daha fazla bilgi için bkz . about_Remote_Jobs.

PowerShell 3.0'dan başlayarak, Start-Job zamanlanmış işler gibi özel iş türlerinin örneklerini başlatabilirsiniz. İşleri özel türlerle başlatmak için kullanma Start-Job hakkında bilgi için iş türü özelliğinin yardım belgelerine bakın.

PowerShell 6.0'da başlayarak ve işareti (&) arka plan işlecini kullanarak işleri başlatabilirsiniz. Arka plan işlecinin işlevselliği ile Start-Jobbenzerdir. bir işi başlatmak için her iki yöntem de psRemotingJob iş nesnesi oluşturur. ve işareti ()& kullanma hakkında daha fazla bilgi için bkz . about_Operators.

PowerShell 7, bir arka plan işinin ilk çalışma dizinini belirten WorkingDirectory parametresini kullanıma sunar. Parametresi belirtilmezse, Start-Job varsayılan olarak işi başlatan çağıranın geçerli çalışma dizinine geçer.

Örnekler

Örnek 1: Arka plan işi başlatma

Bu örnek, yerel bilgisayarda çalışan bir arka plan işi başlatır.

Start-Job -ScriptBlock { Get-Process -Name pwsh }

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

Start-Job, arka plan işi olarak çalıştırmak Get-Process için ScriptBlock parametresini kullanır. Name parametresi, PowerShell işlemlerini pwshbulmak için öğesini belirtir. İş bilgileri görüntülenir ve iş arka planda çalışırken PowerShell bir istem döndürür.

İşin çıkışını görüntülemek için cmdlet'ini Receive-Job kullanın. Örneğin, Receive-Job -Id 1.

Örnek 2: Arka plan işini başlatmak için arka plan işlecini kullanma

Bu örnekte, yerel bilgisayarda bir arka plan işi başlatmak için ve işareti (&) arka plan işleci kullanılır. İş, Örnek 1 ile aynı sonucu Start-Job alır.

Get-Process -Name pwsh &

Id    Name   PSJobTypeName   State       HasMoreData     Location      Command
--    ----   -------------   -----       -----------     --------      -------
5     Job5   BackgroundJob   Running     True            localhost     Microsoft.PowerShell.Man...

Get-Process, PowerShell işlemlerini pwshbelirtmek için Name parametresini kullanır. ve işareti (&) komutu arka plan işi olarak çalıştırır. İş bilgileri görüntülenir ve iş arka planda çalışırken PowerShell bir istem döndürür.

İşin çıkışını görüntülemek için cmdlet'ini Receive-Job kullanın. Örneğin, Receive-Job -Id 5.

Örnek 3: Invoke-Command kullanarak bir iş başlatma

Bu örnek, birden çok bilgisayarda bir iş çalıştırır. İş bir değişkende depolanır ve PowerShell komut satırındaki değişken adı kullanılarak yürütülür.

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

kullanan Invoke-Command bir iş oluşturulur ve değişkende $jobWRM depolanır. Invoke-Command, işin çalıştırıldığı bilgisayarları belirtmek için ComputerName parametresini kullanır. Get-Content dosyadan C:\Servers.txt sunucu adlarını alır.

ScriptBlock parametresi, WinRM hizmetini alan bir komut Get-Service belirtir. JobName parametresi, iş için WinRM adlı kolay bir ad belirtir. ThrottleLimit parametresi eşzamanlı komut sayısını 16 ile sınırlar. AsJob parametresi, sunucularda komutunu çalıştıran bir arka plan işi başlatır.

Örnek 4: İş bilgilerini alma

Bu örnek, bir iş hakkında bilgi alır ve yerel bilgisayarda çalıştırılan tamamlanmış bir işin sonuçlarını görüntüler.

$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, System günlüğünün alındığını belirten Get-WinEvent bir komut çalıştırmak için ScriptBlock parametresini kullanır. Credential parametresi, işi bilgisayarda çalıştırma izni olan bir etki alanı kullanıcı hesabı belirtir. İş nesnesi değişkeninde $j depolanır.

değişkenindeki $j nesnesi işlem hattına Select-Objectgönderilir. Property parametresi, tüm iş nesnesinin özelliklerini görüntülemek için bir yıldız işareti (*) belirtir.

Örnek 5: Arka plan işi olarak betik çalıştırma

Bu örnekte, yerel bilgisayardaki bir betik arka plan işi olarak çalıştırılır.

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

Start-Job, yerel bilgisayarda depolanan bir betik dosyasını belirtmek için FilePath parametresini kullanır.

Örnek 6: Arka plan işi kullanarak işlem alma

Bu örnek, belirtilen işlemi ada göre almak için bir arka plan işi kullanır.

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

Start-JobKolay iş adı (PShellJob) belirtmek için Name parametresini kullanır. ScriptBlock parametresi, Işlemlerin PowerShell adıyla alınacak şekilde belirtmektedirGet-Process.

Örnek 7: Arka plan işi kullanarak veri toplama ve kaydetme

Bu örnek, büyük miktarda harita verisi toplayan ve sonra bir dosyaya kaydeden bir .tif iş başlatır.

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

Start-JobKolay bir iş adı (GetMappingFiles) belirtmek için Name parametresini kullanır. InitializationScript parametresi MapFunctions modülünü içeri aktaran bir betik bloğu çalıştırır. ScriptBlock parametresi çalışır Get-Map ve Set-Content verileri Path parametresi tarafından belirtilen konuma kaydeder.

Örnek 8: Bir arka plan işine giriş geçirme

Bu örnekte, giriş nesnesini işlemek için otomatik değişken kullanılır $input . İşin çıkışını görüntülemek için kullanın Receive-Job .

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

Server01
Server02
Server03
Server04

Start-Jobotomatik değişkenle çalıştırmak Get-Content için ScriptBlock parametresini $input kullanır. değişkeni InputObject $input parametresinden nesneleri alır. Receive-Jobişi belirtmek için Name parametresini kullanır ve sonuçların çıkışını alır. Keep parametresi, powershell oturumu sırasında yeniden görüntülenebilmesi için iş çıkışını kaydeder.

Örnek 9: Arka plan işi için çalışma dizinini ayarlama

WorkingDirectory, betikleri çalıştırabileceğiniz veya dosyaları açabileceğiniz bir iş için alternatif bir dizin belirtmenize olanak tanır. Bu örnekte, arka plan işi geçerli dizin konumundan farklı bir çalışma dizini belirtir.

PS C:\Test> Start-Job -WorkingDirectory C:\Test\Scripts { $PWD } | Receive-Job -AutoRemoveJob -Wait

Path
----
C:\Test\Scripts

Bu örneğin geçerli çalışma dizinidir C:\Test. Start-Jobişin çalışma dizinini belirtmek için WorkingDirectory parametresini kullanır. ScriptBlock parametresi, işin çalışma dizinini görüntülemek için kullanır$PWD. Receive-Job arka plan işinin çıkışını görüntüler. AutoRemoveJob işi siler ve Wait tüm sonuçlar alınana kadar komut istemini gizler.

Örnek 10: Bir dizi belirtmek için ArgumentList parametresini kullanma

Bu örnekte bağımsız değişken dizisi belirtmek için ArgumentList parametresi kullanılır. Dizi, işlem adlarının virgülle ayrılmış bir listesidir.

Start-Job -ScriptBlock { Get-Process -Name $args } -ArgumentList powershell, pwsh, notepad

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

cmdlet'i Start-Job komut çalıştırmak için ScriptBlock parametresini kullanır. Get-Processotomatik değişkenini $argsbelirtmek için Name parametresini kullanır. ArgumentList parametresi, işlem adları dizisini öğesine $argsgeçirir. PowerShell, pwsh ve not defteri işlem adları yerel bilgisayarda çalışan işlemlerdir.

İşin çıkışını görüntülemek için cmdlet'ini Receive-Job kullanın. Örneğin, Receive-Job -Id 1.

Örnek 11: Windows PowerShell 5.1'de iş çalıştırma

Bu örnekte, bir Windows PowerShell 5.1 oturumunda iş çalıştırmak için 5.1 değerine sahip PSVersion parametresi kullanılır.

$PSVersionTable.PSVersion

Major  Minor  Patch  PreReleaseLabel BuildLabel
-----  -----  -----  --------------- ----------
7      0      0      rc.1

$job = Start-Job -ScriptBlock { $PSVersionTable.PSVersion } -PSVersion 5.1
Receive-Job -Job $job

Major  Minor  Build  Revision
-----  -----  -----  --------
5      1      14393  3383

Parametreler

-ArgumentList

-Authentication

-Credential

-DefinitionName

-DefinitionPath

-FilePath

-InitializationScript

-InputObject

-LiteralPath

-Name

-PSVersion

-RunAs32

-ScriptBlock

-Type

-WorkingDirectory

Girişler

String

Name özelliğine sahip bir nesneyi Bu cmdlet'e Name parametresine yöneltebilirsiniz. Örneğin, dosyasından bir FileInfo nesnesine Get-ChildItemkanal oluşturabilirsiniz.

Çıkışlar

System.Management.Automation.PSRemotingJob

Bu cmdlet, başlattığı işi temsil eden bir PSRemotingJob nesnesi döndürür.

Notlar

PowerShell için aşağıdaki diğer adları Start-Jobiçerir:

• Tüm platformlar:
  • sajb

Arka planda çalıştırmak için, Start-Job geçerli oturumda kendi oturumunda çalışır. Cmdlet'ini Invoke-Command kullanarak uzak bilgisayardaki bir Start-Job oturumda komut çalıştırdığınızda, Start-Job uzak oturumdaki bir oturumda çalışır.

İlişkili Bağlantılar

• about_Arrays
• about_Automatic_Variables
• about_Jobs
• about_Job_Details
• about_Remote_Jobs
• Get-Job
• Invoke-Command
• Receive-Job
• Remove-Job
• Stop-Job
• Wait-Job