Get-Job

Başvuru

Modül:: Microsoft.PowerShell.Core

Geçerli oturumda çalışan PowerShell arka plan işlerini alır.

Syntax

Get-Job
   [-IncludeChildJob]
   [-ChildJobState <JobState>]
   [-HasMoreData <Boolean>]
   [-Before <DateTime>]
   [-After <DateTime>]
   [-Newest <Int32>]
   [[-Id] <Int32[]>]
   [<CommonParameters>]

Get-Job
   [-IncludeChildJob]
   [-ChildJobState <JobState>]
   [-HasMoreData <Boolean>]
   [-Before <DateTime>]
   [-After <DateTime>]
   [-Newest <Int32>]
   [-InstanceId] <Guid[]>
   [<CommonParameters>]

Get-Job
   [-IncludeChildJob]
   [-ChildJobState <JobState>]
   [-HasMoreData <Boolean>]
   [-Before <DateTime>]
   [-After <DateTime>]
   [-Newest <Int32>]
   [-Name] <String[]>
   [<CommonParameters>]

Get-Job
   [-IncludeChildJob]
   [-ChildJobState <JobState>]
   [-HasMoreData <Boolean>]
   [-Before <DateTime>]
   [-After <DateTime>]
   [-Newest <Int32>]
   [-State] <JobState>
   [<CommonParameters>]

Get-Job
   [-IncludeChildJob]
   [-ChildJobState <JobState>]
   [-HasMoreData <Boolean>]
   [-Before <DateTime>]
   [-After <DateTime>]
   [-Newest <Int32>]
   [-Command <String[]>]
   [<CommonParameters>]

Get-Job
   [-Filter] <Hashtable>
   [<CommonParameters>]

Description

Cmdlet, Get-Job geçerli oturumda başlatılan arka plan işlerini temsil eden nesneleri alır. cmdlet'ini kullanarak Start-Job veya herhangi bir cmdlet'in AsJob parametresini kullanarak başlatılan işleri almak için kullanabilirsinizGet-Job.

Parametreler olmadan, bir Get-Job komut geçerli oturumdaki tüm işleri alır. Belirli işleri almak için parametresini Get-Job kullanabilirsiniz.

Döndüren Get-Job iş nesnesi, iş hakkında yararlı bilgiler içerir, ancak iş sonuçlarını içermez. Sonuçları almak için cmdlet'ini Receive-Job kullanın.

Windows PowerShell arka plan işi, geçerli oturumla etkileşim kurmadan arka planda çalışan bir komutdur. Genellikle, tamamlanması uzun süren karmaşık bir komutu çalıştırmak için bir arka plan işi kullanırsınız. Windows PowerShell'deki arka plan işleri hakkında daha fazla bilgi için bkz . about_Jobs.

Windows PowerShell 3.0'dan Get-Job başlayarak, cmdlet iş akışı işleri ve zamanlanmış işlerin örnekleri gibi özel iş türlerini de alır. Bir işin iş türünü bulmak için işin PSJobTypeName özelliğini kullanın.

Özel bir iş türü almayı etkinleştirmek Get-Job için, cmdlet'ini kullanarak veya modülde bir cmdlet'i kullanarak Import-Module veya alarak bir Get-Job komut çalıştırmadan önce özel iş türünü destekleyen modülü oturuma aktarın. Belirli bir özel iş türü hakkında bilgi için özel iş türü özelliğinin belgelerine bakın.

Örnekler

Örnek 1: Geçerli oturumda tüm arka plan işlerini başlatma

Bu komut tüm arka plan işlerinin geçerli oturumda başlatılmasını sağlar. İşler yerel bilgisayarda çalıştırılsa bile diğer oturumlarda oluşturulan işleri içermez.

Get-Job

Id     Name            PSJobTypeName   State         HasMoreData     Location             Command
--     ----            -------------   -----         -----------     --------             -------
1      Job1            BackgroundJob   Completed     True            localhost             $env:COMPUTERNAME

Örnek 2: Örnek kimliği kullanarak işi durdurma

Bu komutlar, bir işin örnek kimliğinin nasıl alınacağını ve bir işi durdurmak için nasıl kullanılacağını gösterir. Benzersiz olmayan bir işin adından farklı olarak örnek kimliği benzersizdir.

İlk komut, iş almak için cmdlet'ini kullanır Get-Job . İşi tanımlamak için Name parametresini kullanır. komutu, değişkeninde $j döndüren Get-Job iş nesnesini depolar. Bu örnekte, belirtilen ada sahip yalnızca bir iş vardır. İkinci komut, değişkenindeki nesnesinin $j InstanceId özelliğini alır ve değişkende $ID depolar. Üçüncü komut değişkeninin $ID değerini görüntüler. Dördüncü komut, işi durdurmak için cmdlet'i kullanır Stop-Job . İşin örnek kimliğini temsil eden işi ve $ID değişkeni tanımlamak için InstanceId parametresini kullanır.

$j = Get-Job -Name Job1
$ID = $j.InstanceID
$ID

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

Stop-Job -InstanceId $ID

Örnek 3: Belirli bir komutu içeren işleri alma

Bu komut, sistemdeki komut Get-Process içeren işleri alır. komutu, alınan işleri sınırlamak için command parametresini Get-Job kullanır. Komut, komut dizesinin herhangi bir Get-Process yerinde komut içeren işleri almak için joker karakterler (*) kullanır.

Get-Job -Command "*Get-Process*"

Id     Name            PSJobTypeName   State         HasMoreData     Location             Command
--     ----            -------------   -----         -----------     --------             -------
3      Job3            BackgroundJob   Running       True            localhost            Get-Process

Örnek 4: İşlem hattını kullanarak belirli bir komutu içeren işleri alma

Önceki örnekteki komutu gibi bu komut da sistemdeki komut Get-Process içeren işleri alır. Komut, cmdlet'ine NoteProperty Komutu ile bir PSCustomObject göndermek için Get-Job işlem hattı işlecini (|) kullanır. Önceki komutun eşdeğeridir.

[pscustomobject]@{Command='*Get-Process*'} | Get-Job

Id     Name            PSJobTypeName   State         HasMoreData     Location             Command
--     ----            -------------   -----         -----------     --------             -------
3      Job3            BackgroundJob   Running       True            localhost            Get-Process

Örnek 5: Başlatılmamış işleri alma

Bu komut yalnızca oluşturulmuş ancak henüz başlatılmamış işleri alır. Bu, gelecekte çalıştırılacak şekilde zamanlanmış ve henüz zamanlanmamış işleri içerir.

Get-Job -State NotStarted

Örnek 6: Ad atanmamış işleri alma

Bu komut, işle başlayan iş adları olan tüm işleri alır. job<number> Bir işin varsayılan adı olduğundan, bu komut açıkça atanmış bir ada sahip olmayan tüm işleri alır.

Get-Job -Name Job*

Id     Name            PSJobTypeName   State         HasMoreData     Location             Command
--     ----            -------------   -----         -----------     --------             -------
1      Job1            BackgroundJob   Completed     True            localhost             $env:COMPUTERNAME

Örnek 7: bir komuttaki işi temsil etmek için iş nesnesi kullanma

Bu örnek, bir iş nesnesini almak için nasıl kullanılacağını Get-Job ve ardından bir komutta işi temsil etmek için iş nesnesinin nasıl kullanılacağını gösterir.

İlk komut, cmdlet'ini Start-Job kullanarak yerel bilgisayarda bir komut çalıştıran bir Get-Process arka plan işi başlatır. Komutu, işe kolay bir ad atamak için Name parametresini Start-Job kullanır. İkinci komut işi almak için kullanır Get-Job . İşi tanımlamak için Name parametresini Get-Job kullanır. komutu, sonuçta elde edilen iş nesnesini değişkene $j kaydeder. Üçüncü komut, değişkendeki iş nesnesinin $j değerini görüntüler. State özelliğinin değeri işin tamamlandığını gösterir. HasMoreData özelliğinin değeri, işten henüz alınmamış sonuçlar olduğunu gösterir. Dördüncü komut, işin sonuçlarını almak için cmdlet'ini kullanır Receive-Job . değişkenindeki $j iş nesnesini kullanarak işi temsil eder. İş nesnesini Receive-Jobadresine göndermek için bir işlem hattı işleci de kullanabilirsiniz.

Start-Job -ScriptBlock {Get-Process} -Name MyJob
$j = Get-Job -Name MyJob
$j

Id     Name            PSJobTypeName   State         HasMoreData     Location             Command
--     ----            -------------   -----         -----------     --------             -------
6      MyJob           BackgroundJob   Completed     True            localhost            Get-Process

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
...

Örnek 8: farklı bir yöntemle başlatılan işler dahil olmak üzere tüm işleri alma

Bu örnek, cmdlet'in farklı yöntemler kullanılarak başlatılmış olsalar bile geçerli oturumda başlatılan tüm işleri alabileceğini gösterir Get-Job .

İlk komut, yerel bilgisayarda bir iş başlatmak için cmdlet'ini kullanır Start-Job . İkinci komut, S1 bilgisayarında bir iş başlatmak için cmdlet'in Invoke-Command AsJob parametresini kullanır. İşteki komutlar uzak bilgisayarda çalıştırılıyor olsa da, iş nesnesi yerel bilgisayarda oluşturulur, bu nedenle işi yönetmek için yerel komutları kullanırsınız. Üçüncü komut, S2 bilgisayarında bir Start-Job komut çalıştırmak için cmdlet'ini kullanırInvoke-Command. Bu yöntem kullanılarak, iş nesnesi uzak bilgisayarda oluşturulur, bu nedenle işi yönetmek için uzak komutları kullanırsınız. Dördüncü komut, yerel bilgisayarda depolanan işleri almak için kullanır Get-Job . Windows PowerShell 3.0'da tanıtılan işlerin PSJobTypeName özelliği, cmdlet'i kullanılarak Start-Job başlatılan yerel işin bir arka plan işi olduğunu ve cmdlet'i kullanılarak Invoke-Command uzak oturumda başlatılan işin uzak bir iş olduğunu gösterir. Beşinci, altıncı ve yedinci komut cmdlet'ini New-PSSession kullanarak S2 bilgisayara bağlı bir PSSession oluşturur, PSSession ve Session parametresini kullanarak uzak bilgisayarda bir iş başlatmak için kullanırInvoke-Command. Ardından S2 bilgisayarda PSSession komutunu kullanarak işi Get-Job alır. Örnek çıktı, komutun Get-Job sonuçlarını gösterir. S2 bilgisayarında, iş yerel bir iş gibi görünür. Bilgisayar adı localhost, iş türü ise arka plan işidir. Uzak bilgisayarlarda arka plan işlerini çalıştırma hakkında daha fazla bilgi için bkz . about_Remote_Jobs.

Start-Job -ScriptBlock {Get-EventLog -LogName System}
Invoke-Command -ComputerName S1 -ScriptBlock {Get-EventLog -LogName System} -AsJob
Invoke-Command -ComputerName S2 -ScriptBlock {Start-Job -ScriptBlock {Get-EventLog -LogName System}}
Get-Job

Id     Name       PSJobTypeName   State         HasMoreData     Location        Command
--     ----       -------------   -----         -----------     --------        -------
1      Job1       BackgroundJob   Running       True            localhost       Get-EventLog System
2      Job2       RemoteJob       Running       True            S1              Get-EventLog System

$Session = New-PSSession -ComputerName S2
Invoke-Command -Session $Session -ScriptBlock {Start-Job -ScriptBlock {Get-EventLog -LogName System}}
Invoke-Command -Session $Session -ScriptBlock {Get-Job}

Id     Name            PSJobTypeName   State         HasMoreData     Location             Command                   PSComputerName
--     ----            -------------   -----         -----------     --------             -------                   --------------
1      Job1            BackgroundJob   Running       True            localhost            Get-EventLog -LogName Sy… S2

Örnek 9: Başarısız bir işi araştırma

Bu komut, bir işin neden başarısız olduğunu araştırmak için geri dönen Get-Job iş nesnesinin nasıl kullanılacağını gösterir. Ayrıca her işin alt işlerini nasıl edineceklerini de gösterir.

İlk komut, yerel bilgisayarda bir iş başlatmak için cmdlet'ini kullanır Start-Job . Döndüren Start-Job iş nesnesi işin başarısız olduğunu gösterir. State özelliğinin değeri Failed değeridir.

İkinci komut, işi almak için cmdlet'ini kullanır Get-Job . komutu, nesnenin JobStateInfo özelliğinin değerini almak için dot yöntemini kullanır. JobStateInfo özelliğindeki Format-List nesneyi bir listedeki nesnenin (*) tüm özelliklerini biçimlendiren cmdlet'ine göndermek için bir işlem hattı işleci kullanır. komutunun Format-List sonucu, işin Reason özelliğinin değerinin boş olduğunu gösterir.

Üçüncü komut daha fazlasını araştırır. İşi almak için bir Get-Job komut kullanır ve ardından bir işlem hattı işlecini kullanarak işin tüm özelliklerini bir listede görüntüleyen cmdlet'ine iş nesnesinin Format-List tamamını gönderir. İş nesnesindeki tüm özelliklerin görüntülenmesi, işin job2 adlı bir alt iş içerdiğini gösterir.

Dördüncü komut Job2 alt işini temsil eden iş nesnesini almak için kullanır Get-Job . Bu, komutun gerçekten çalıştırıldığı iştir. JobStateInfo özelliğinin Reason özelliğini almak için dot yöntemini kullanır. Sonuç, erişim reddedildi hatası nedeniyle işin başarısız olduğunu gösterir. Bu durumda, kullanıcı Windows PowerShell'i başlatırken Yönetici olarak çalıştır seçeneğini kullanmayı unuttu.Arka plan işleri Windows PowerShell'in uzaktan iletişim özelliklerini kullandığından, iş yerel bilgisayarda çalıştırıldığında bile bilgisayarın bir işi çalıştıracak uzaktan iletişim için yapılandırılması gerekir. Windows PowerShell'de uzaktan iletişim gereksinimleri hakkında bilgi için bkz . about_Remote_Requirements. Sorun giderme ipuçları için bkz . about_Remote_Troubleshooting.

PS> Start-Job -ScriptBlock {Get-Process}
Id     Name       PSJobTypeName   State       HasMoreData     Location             Command
--     ----       -------------   -----       -----------     --------             -------
1      Job1       BackgroundJob   Failed      False           localhost            Get-Process

PS> (Get-Job).JobStateInfo | Format-List -Property *
State  : Failed
Reason :

PS> Get-Job | Format-List -Property *
HasMoreData   : False
StatusMessage :
Location      : localhost
Command       : get-process
JobStateInfo  : Failed
Finished      : System.Threading.ManualReset
EventInstanceId    : fb792295-1318-4f5d-8ac8-8a89c5261507
Id            : 1
Name          : Job1
ChildJobs     : {Job2}
Output        : {}
Error         : {}
Progress      : {}
Verbose       : {}
Debug         : {}
Warning       : {}
StateChanged  :

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.

Örnek 10: Filtrelenmiş sonuçları alma

Bu örnekte, bir iş akışı işi almak için Filter parametresinin nasıl kullanılacağı gösterilmektedir. Windows PowerShell 3.0'da sunulan Filter parametresi yalnızca iş akışı işleri ve zamanlanmış işler gibi özel iş türlerinde geçerlidir.

İlk komut, WFProcess iş akışını oluşturmak için workflow anahtar sözcüğünü kullanır. İkinci komut, iş akışını arka plan işi olarak çalıştırmak için WFProcess iş akışının AsJob parametresini kullanır. İş için bir ad belirtmek üzere iş akışının JobName parametresini ve özel bir kimlik belirtmek için iş akışının PSPrivateMetadata parametresini kullanır. Üçüncü komut, işi PSPrivateMetadata parametresinde belirtilen özel kimlikle almak için filter parametresini Get-Job kullanır.

PS> Workflow WFProcess {Get-Process}
PS> WFProcess -AsJob -JobName WFProcessJob -PSPrivateMetadata @{MyCustomId = 92107}
PS> Get-Job -Filter @{MyCustomId = 92107}
Id     Name            State         HasMoreData     Location             Command
--     ----            -----         -----------     --------             -------
1      WFProcessJob    Completed     True            localhost            WFProcess

Örnek 11: Alt işler hakkında bilgi alma

Bu örnek, cmdlet'in IncludeChildJob ve ChildJobState parametrelerini Get-Job kullanmanın etkisini gösterir.

İlk komut, geçerli oturumdaki işleri alır. Çıktı bir arka plan işi, uzak bir iş ve zamanlanmış bir işin birkaç örneğini içerir. Job4 uzak işi başarısız olmuş gibi görünüyor. İkinci komut, öğesinin IncludeChildJob parametresini Get-Jobkullanır. Çıkış, alt işleri olan tüm işlerin alt işlerini ekler. Bu durumda, düzeltilen çıkış, Job4'ün yalnızca Job5 alt işinin başarısız olduğunu gösterir. Üçüncü komut, ChildJobState parametresini Failed değeriyle kullanır.Çıktı tüm üst işleri ve yalnızca başarısız olan alt işleri içerir. Beşinci komut, job5'in neden başarısız olduğunu keşfetmek için işlerin JobStateInfo özelliğini ve Reason özelliğini kullanır.

PS> Get-Job

Id     Name            PSJobTypeName   State         HasMoreData     Location             Command
--     ----            -------------   -----         -----------     --------             -------
2      Job2            BackgroundJob   Completed     True            localhost            .\Get-Archive.ps1
4      Job4            RemoteJob       Failed        True            Server01, Server02   .\Get-Archive.ps1
7      UpdateHelpJob   PSScheduledJob  Completed     True            localhost            Update-Help
8      UpdateHelpJob   PSScheduledJob  Completed     True            localhost            Update-Help
9      UpdateHelpJob   PSScheduledJob  Completed     True            localhost            Update-Help
10     UpdateHelpJob   PSScheduledJob  Completed     True            localhost            Update-Help

PS> Get-Job -IncludeChildJob

Id     Name            PSJobTypeName   State         HasMoreData     Location             Command
--     ----            -------------   -----         -----------     --------             -------
2      Job2            BackgroundJob   Completed     True            localhost           .\Get-Archive.ps1
3      Job3                            Completed     True            localhost           .\Get-Archive.ps1
4      Job4            RemoteJob       Failed        True            Server01, Server02  .\Get-Archive.ps1
5      Job5                            Failed        False           Server01            .\Get-Archive.ps1
6      Job6                            Completed     True            Server02            .\Get-Archive.ps1
7      UpdateHelpJob   PSScheduledJob  Completed     True            localhost            Update-Help
8      UpdateHelpJob   PSScheduledJob  Completed     True            localhost            Update-Help
9      UpdateHelpJob   PSScheduledJob  Completed     True            localhost            Update-Help
10     UpdateHelpJob   PSScheduledJob  Completed     True            localhost            Update-Help

PS> Get-Job -Name Job4 -ChildJobState Failed

Id     Name            PSJobTypeName   State         HasMoreData     Location             Command
--     ----            -------------   -----         -----------     --------             -------
2      Job2            BackgroundJob   Completed     True            localhost           .\Get-Archive.ps1
4      Job4            RemoteJob       Failed        True            Server01, Server02  .\Get-Archive.ps1
5      Job5                            Failed        False           Server01            .\Get-Archive.ps1
7      UpdateHelpJob   PSScheduledJob  Completed     True            localhost            Update-Help
8      UpdateHelpJob   PSScheduledJob  Completed     True            localhost            Update-Help
9      UpdateHelpJob   PSScheduledJob  Completed     True            localhost            Update-Help
10     UpdateHelpJob   PSScheduledJob  Completed     True            localhost            Update-Help

PS> (Get-Job -Name Job5).JobStateInfo.Reason

Connecting to remote server Server01 failed with the following error message:
Access is denied.

Daha fazla bilgi için about_Remote_Troubleshooting Yardım konusuna bakın.

Parametreler

-After

Belirtilen tarih ve saatten sonra sona eren tamamlanmış işleri alır. Cmdlet'i tarafından Get-Date döndürülen bir veya veya 11/06gibi bir DateTime nesnesine dönüştürülebilen bir dize gibi Dec 1, 2012 2:00 AM bir DateTime nesnesi girin.

Bu parametre yalnızca EndTime özelliğine sahip iş akışı işleri ve zamanlanmış işler gibi özel iş türlerinde çalışır. Cmdlet'i kullanılarak Start-Job oluşturulanlar gibi standart arka plan işlerinde çalışmaz. Bu parametre desteği hakkında bilgi için iş türü için yardım konusuna bakın.

Bu parametre Windows PowerShell 3.0'da kullanıma sunulmuştur.

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

-Before

Belirtilen tarih ve saatten önce sona eren tamamlanmış işleri alır. Bir DateTime nesnesi girin.

Bu parametre Windows PowerShell 3.0'da kullanıma sunulmuştur.

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

-ChildJobState

Yalnızca belirtilen duruma sahip alt işleri alır. Bu parametrenin kabul edilebilir değerleri şunlardır:

NotStarted
Çalışıyor
Tamamlandı
Başarısız
Durduruldu
Engellendi
Askıya alındı
Bağlantı kesildi
Askıya alınıyor
Durduruluyor

Varsayılan olarak, Get-Job alt işleri almaz. IncludeChildJob parametresini Get-Job kullanarak tüm alt işleri alır. ChildJobState parametresini kullanırsanız IncludeChildJob parametresinin hiçbir etkisi olmaz.

Bu parametre Windows PowerShell 3.0'da kullanıma sunulmuştur.

Type:	JobState
Accepted values:	NotStarted, Running, Completed, Failed, Stopped, Blocked, Suspended, Disconnected, Suspending, Stopping, AtBreakpoint
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Command

Dize olarak bir komut dizisi belirtir. Bu cmdlet, belirtilen komutları içeren işleri alır. Varsayılan değer tüm işlerdir. Komut deseni belirtmek için joker karakterler kullanabilirsiniz.

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

-Filter

Koşulların karma tablosunu belirtir. Bu cmdlet tüm koşulları karşılayan işleri alır. Anahtarların iş özellikleri, değerlerin ise iş özelliği değerleri olduğu bir karma tablo girin.

Bu parametre yalnızca iş akışı işleri ve zamanlanmış işler gibi özel iş türlerinde çalışır. Cmdlet'i kullanılarak Start-Job oluşturulanlar gibi standart arka plan işlerinde çalışmaz. Bu parametre desteği hakkında bilgi için iş türü için yardım konusuna bakın.

Bu parametre Windows PowerShell 3.0'da kullanıma sunulmuştur.

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

-HasMoreData

Bu cmdlet'in yalnızca belirtilen HasMoreData özellik değerine sahip işleri alıp almadığını gösterir. HasMoreData özelliği, geçerli oturumda tüm iş sonuçlarının alınıp alınmadığını gösterir. Daha fazla sonuç içeren işleri almak için değerini $Truebelirtin. Daha fazla sonucu olmayan işleri almak için değerini $Falsebelirtin.

Bir işin sonuçlarını almak için cmdlet'ini Receive-Job kullanın.

Cmdlet'ini Receive-Job kullandığınızda, bellek içi, oturuma özgü depolama alanından döndürdüğünüz sonuçları siler. Geçerli oturumdaki işin tüm sonuçlarını döndürdüyse, işin HasMoreData özelliğinin değerini , geçerli oturumdaki iş $Falseiçin başka sonuç olmadığını belirtmek üzere olarak ayarlar. Sonuçların silinmesini ve HasMoreData özelliğinin değerinin değiştirilmesini önlemek Receive-Job için Keep parametresini Receive-Job kullanın. Daha fazla bilgi için yazın Get-Help Receive-Job.

HasMoreData özelliği geçerli oturuma özgüdür. Özel bir iş türünün sonuçları, zamanlanmış iş türü gibi oturumun dışında kaydediliyorsa ve bu da iş sonuçlarını diske kaydederse, HasMoreData $False değeri olsa bile iş sonuçlarını yeniden almak için cmdlet'ini farklı bir oturumda kullanabilirsinizReceive-Job. Daha fazla bilgi için özel iş türünün yardım konularına bakın.

Bu parametre Windows PowerShell 3.0'da kullanıma sunulmuştur.

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

-Id

Bu cmdlet'in aldığı bir iş kimlikleri dizisini belirtir.

Kimlik, geçerli oturumdaki işi benzersiz olarak tanımlayan bir tamsayıdır. Anımsamak ve yazmak örnek kimliğinden daha kolaydır, ancak yalnızca geçerli oturumda benzersizdir. Virgülle ayrılmış bir veya daha fazla kimlik yazabilirsiniz. İşin kimliğini bulmak için parametresiz yazın Get-Job .

Type:	Int32[]
Position:	0
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-IncludeChildJob

Bu cmdlet'in üst işlere ek olarak alt işleri döndürdüğünü gösterir.

Bu parametre özellikle bir kapsayıcı üst işi döndüren Get-Job iş akışı işlerini araştırmak ve iş hataları için kullanışlıdır çünkü hatanın nedeni alt işin bir özelliğine kaydedilir.

Bu parametre Windows PowerShell 3.0'da kullanıma sunulmuştur.

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

-InstanceId

Bu cmdlet'in aldığı işlerin örnek kimlikleri dizisini belirtir. Varsayılan değer tüm işlerdir.

Örnek kimliği, bilgisayardaki işi benzersiz olarak tanımlayan bir GUID'dir. bir işin örnek kimliğini bulmak için kullanın Get-Job.

Type:	Guid[]
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Name

Bu cmdlet'in aldığı işlerin örnek kolay adlarının bir dizisini belirtir. bir iş adı girin veya bir iş adı deseni girmek için joker karakterler kullanın. Varsayılan olarak, Get-Job geçerli oturumdaki tüm işleri alır.

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

-Newest

Alınacak iş sayısını belirtir. Bu cmdlet en son sona eren işleri alır.

En Yeni parametresi, en yeni işleri son zaman düzeninde sıralamaz veya döndürmez. Çıkışı sıralamak için cmdlet'ini Sort-Object kullanın.

Bu parametre Windows PowerShell 3.0'da kullanıma sunulmuştur.

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

-State

bir iş durumu belirtir. Bu cmdlet yalnızca belirtilen durumdaki işleri alır. Bu parametrenin kabul edilebilir değerleri şunlardır:

NotStarted
Çalışıyor
Tamamlandı
Başarısız
Durduruldu
Engellendi
Askıya alındı
Bağlantı kesildi
Askıya alınıyor
Durduruluyor

Varsayılan olarak, Get-Job geçerli oturumdaki tüm işleri alır.

İş durumları hakkında daha fazla bilgi için bkz . JobState Numaralandırması.

Type:	JobState
Accepted values:	NotStarted, Running, Completed, Failed, Stopped, Blocked, Suspended, Disconnected, Suspending, Stopping, AtBreakpoint
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

Girişler

None

Nesneleri bu cmdlet'e yöneltemezsiniz.

Çıkışlar

System.Management.Automation.RemotingJob

Bu cmdlet, oturumdaki işleri temsil eden nesneleri döndürür.

Notlar

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

Tüm platformlar:
- gjb

İşlerin PSJobTypeName özelliği, işin iş türünü gösterir. Özellik değeri, iş türü yazarı tarafından belirlenir. Aşağıdaki listede yaygın iş türleri gösterilmektedir.

BackgroundJob. kullanılarak Start-Jobbaşlatılan yerel iş.
RemoteJob. İş, cmdlet'in AsJob parametresi kullanılarak PSSession'da Invoke-Command başlatıldı.
PSWorkflowjob. İş, iş akışlarının AsJob ortak parametresi kullanılarak başlatılır.

Get-Job

Syntax

Description

Örnekler

Örnek 1: Geçerli oturumda tüm arka plan işlerini başlatma

Örnek 2: Örnek kimliği kullanarak işi durdurma

Örnek 3: Belirli bir komutu içeren işleri alma

Örnek 4: İşlem hattını kullanarak belirli bir komutu içeren işleri alma

Örnek 5: Başlatılmamış işleri alma

Örnek 6: Ad atanmamış işleri alma

Örnek 7: bir komuttaki işi temsil etmek için iş nesnesi kullanma

Örnek 8: farklı bir yöntemle başlatılan işler dahil olmak üzere tüm işleri alma

Örnek 9: Başarısız bir işi araştırma

Örnek 10: Filtrelenmiş sonuçları alma

Örnek 11: Alt işler hakkında bilgi alma

Parametreler

-After

-Before

-ChildJobState

-Command

-Filter

-HasMoreData

-Id

-IncludeChildJob

-InstanceId

-Name

-Newest

-State

Girişler

Çıkışlar

Notlar

Geri Bildirim

Ek kaynaklar

Get-Job

Syntax

Description

Örnekler

Örnek 1: Geçerli oturumda tüm arka plan işlerini başlatma

Örnek 2: Örnek kimliği kullanarak işi durdurma

Örnek 3: Belirli bir komutu içeren işleri alma

Örnek 4: İşlem hattını kullanarak belirli bir komutu içeren işleri alma

Örnek 5: Başlatılmamış işleri alma

Örnek 6: Ad atanmamış işleri alma

Örnek 7: bir komuttaki işi temsil etmek için iş nesnesi kullanma

Örnek 8: farklı bir yöntemle başlatılan işler dahil olmak üzere tüm işleri alma

Örnek 9: Başarısız bir işi araştırma

Örnek 10: Filtrelenmiş sonuçları alma

Örnek 11: Alt işler hakkında bilgi alma

Parametreler

-After

-Before

-ChildJobState

-Command

-Filter

-HasMoreData

-Id

-IncludeChildJob

-InstanceId

-Name

-Newest

-State

Girişler

Çıkışlar

Notlar

İlişkili Bağlantılar

Geri Bildirim

Ek kaynaklar