Get-Job

Başvuru

Modül:: Microsoft.PowerShell.Core

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

Sözdizimi

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

Get-Job cmdlet'i geçerli oturumda başlatılan arka plan işlerini temsil eden nesneleri alır. Get-Job cmdlet'i kullanılarak veya herhangi bir cmdlet'in Start-Job parametresi kullanılarak başlatılan işleri almak için kullanabilirsiniz.

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

Get-Job döndüren iş nesnesi iş hakkında yararlı bilgiler içerir, ancak iş sonuçlarını içermez. Sonuçları almak için Receive-Job cmdlet'ini 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 başlayarak, Get-Job cmdlet'i iş akışı işleri ve zamanlanmış işlerin örnekleri gibi özel iş türlerini de alır. İşin iş türünü bulmak için işin PSJobTypeName özelliğini kullanın.

Get-Job özel bir iş türü almasını sağlamak için, Get-Job cmdlet'ini kullanarak veya modülde bir cmdlet'i kullanarak veya alarak bir Import-Module komutu ç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 Get-Job cmdlet'ini kullanır. İşi tanımlamak için Name parametresini kullanır. komut, Get-Job döndüren iş nesnesini $j değişkeninde depolar. Bu örnekte, belirtilen ada sahip yalnızca bir iş vardır. İkinci komut, değişkenindeki nesnenin $j özelliğini alır ve $ID değişkeninde depolar. Üçüncü komut, $ID değişkeninin değerini görüntüler. Dördüncü komut, işi durdurmak için Stop-Job cmdlet'ini kullanır. İşi tanımlamak için InstanceId parametresini ve işin örnek kimliğini göstermek için değişkeni $ID 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 Get-Process komutu içeren işleri alır. Komut, alınan işleri sınırlamak için Get-Job parametresini kullanır. Komut, komut dizesinin herhangi bir yerinde * komutu içeren işleri almak için joker karakterler (Get-Process) 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 komut gibi bu komut da sistemdeki Get-Process komutu içeren işleri alır. Komut, | cmdlet'ine NoteProperty Commandile psCustomObject göndermek için bir işlem hattı işleci (Get-Job) 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 örnekte, bir iş nesnesi almak için Get-Job nasıl kullanılacağı ve ardından bir komuttaki işi temsil etmek için iş nesnesinin nasıl kullanılacağı gösterilmektedir.

İlk komut, yerel bilgisayarda Start-Job komutu çalıştıran bir arka plan işi başlatmak için Get-Process cmdlet'ini kullanır. Komut, işe kolay bir ad atamak için Start-Job parametresini kullanır. İkinci komut, işi almak için Get-Job kullanır. İşi tanımlamak için Get-Job parametresini kullanır. komutu, sonuçta elde edilen iş nesnesini $j değişkenine kaydeder. Üçüncü komut, $j değişkeninde iş nesnesinin 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 Receive-Job cmdlet'ini kullanır. İşi temsil etmek için $j değişkenindeki iş nesnesini kullanır. İş nesnesini Receive-Jobgöndermek için işlem hattı işlecini 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 örnekte, Get-Job cmdlet'inin farklı yöntemler kullanılarak başlatılmış olsalar bile geçerli oturumda başlatılan tüm işleri alabileceğini gösterir.

İlk komut, yerel bilgisayarda bir iş başlatmak için Start-Job cmdlet'ini kullanır. İkinci komut, S1 bilgisayarında bir iş başlatmak için cmdlet'in Invoke-Command 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 Invoke-Command komutu çalıştırmak için Start-Job cmdlet'ini kullanır. 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 Get-Job kullanır. Windows PowerShell 3.0'da tanıtılan işlerin PSJobTypeName özelliği, Start-Job cmdlet'i kullanılarak başlatılan yerel işin bir arka plan işi olduğunu ve Invoke-Command cmdlet'i kullanılarak uzak oturumda başlatılan işin uzak bir iş olduğunu gösterir. Beşinci, altıncı ve yedinci komut, S2 bilgisayara bağlı bir PSSession oluşturmak için New-PSSession cmdlet'ini kullanır, PSSession ve Invoke-Command parametresini kullanarak uzak bilgisayarda bir iş başlatmak için kullanır. Ardından pssession kullanarak S2 bilgisayarda Get-Job komutunu kullanarak işi alır. Örnek çıktı, Get-Job komutunun 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 Get-Job döndüren 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 Start-Job cmdlet'ini kullanır. Start-Job döndüren iş nesnesi işin başarısız olduğunu gösterir. Durumu özelliğinin değeri Başarısız'dır.

İkinci komut, işi almak için Get-Job cmdlet'ini kullanır. komutu, nesnenin JobStateInfo özelliğinin değerini almak için dot yöntemini kullanır. JobStateInfo özelliğindeki nesneyi, listedeki nesnenin (Format-List) tüm özelliklerini biçimlendiren * cmdlet'ine göndermek için işlem hattı işlecini kullanır. Format-List komutunun 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 komutu kullanır ve ardından bir işlem hattı işlecini kullanarak iş nesnesinin tamamını Format-List cmdlet'ine gönderir ve bu komut işin tüm özelliklerini bir listede görüntüler. İş 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 Get-Job kullanır. 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 Filtresi 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 Get-JobFilter parametresini 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 örnekte, cmdlet'in IncludeChildJob ve Get-Job parametrelerini kullanmanın etkisi gösterilmektedir.

İ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, Get-Job parametresini kullanı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, failed değeriyle ChildJobState parametresini 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 döndürülen veya Get-Date veya gibi Dec 1, 2012 2:00 AM nesnesine dönüştürülebilen bir dize gibi bir 11/06 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. Start-Job cmdlet'i kullanılarak 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.

Tür:	DateTime
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	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.

Tür:	DateTime
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-ChildJobState

Yalnızca belirtilen duruma sahip alt işleri alır. Bu parametre için kabul edilebilir değerler şunlardır:

Başlamadı
Koşarak
Tamamlandı
Başarısız
Durdu
Engellenmiş
Askıya
Bağlantısı kesilmiş
Askıya
Durdurma

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

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

Tür:	JobState
Kabul edilen değerler:	NotStarted, Running, Completed, Failed, Stopped, Blocked, Suspended, Disconnected, Suspending, Stopping, AtBreakpoint
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	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.

Tür:	String[]
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	True
Joker karakterleri kabul et:	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. Start-Job cmdlet'i kullanılarak 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.

Tür:	Hashtable
Position:	0
Default value:	None
Gerekli:	True
İşlem hattı girişini kabul et:	True
Joker karakterleri kabul et:	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 $truedeğerini belirtin. Daha fazla sonucu olmayan işleri almak için $falsedeğerini belirtin.

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

Receive-Job cmdlet'ini 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 $false) olarak ayarlayarak geçerli oturumdaki iş için başka sonuç olmadığını gösterir. sonuçları silmesini ve Receive-Job özelliğinin değerini değiştirmesini önlemek için Receive-JobKeep parametresini kullanın. Daha fazla bilgi için Get-Help Receive-Jobyazın.

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, Receive-Job değeri olsa bile iş sonuçlarını yeniden almak için $false cmdlet'ini farklı bir oturumda kullanabilirsiniz. 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.

Tür:	Boolean
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	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 Get-Job yazın.

Tür:	Int32[]
Position:	0
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	True
Joker karakterleri kabul et:	False

-IncludeChildJob

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

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

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

Tür:	SwitchParameter
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	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 Get-Jobkullanın.

Tür:	Guid[]
Position:	0
Default value:	None
Gerekli:	True
İşlem hattı girişini kabul et:	True
Joker karakterleri kabul et:	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.

Tür:	String[]
Position:	0
Default value:	None
Gerekli:	True
İşlem hattı girişini kabul et:	True
Joker karakterleri kabul et:	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 Sort-Object cmdlet'ini kullanın.

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

Tür:	Int32
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-State

bir iş durumu belirtir. Bu cmdlet yalnızca belirtilen durumdaki işleri alır. Bu parametre için kabul edilebilir değerler şunlardır:

Başlamadı
Koşarak
Tamamlandı
Başarısız
Durdu
Engellenmiş
Askıya
Bağlantısı kesilmiş
Askıya
Durdurma

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

Tür:	JobState
Kabul edilen değerler:	NotStarted, Running, Completed, Failed, Stopped, Blocked, Suspended, Disconnected, Suspending, Stopping, AtBreakpoint
Position:	0
Default value:	None
Gerekli:	True
İşlem hattı girişini kabul et:	True
Joker karakterleri kabul et:	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, Get-Jobiçin aşağıdaki diğer adları iç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 . Start-Jobkullanılarak başlatılan yerel iş.
RemoteJob . İş, cmdlet'in AsJob parametresi kullanılarak Invoke-Command başladı.
PSWorkflowJob . İş, iş akışlarının ortak parametresi AsJob kullanılarak başlatıldı.

Aracılığıyla paylaş

Get-Job

Sözdizimi

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