Start-Job
PowerShell'de bir arka plan işi başlatır.
Sözdizimi
ComputerName EnterprisePublishing
Start-Job
[-ScriptBlock] <ScriptBlock>
[[-InitializationScript] <ScriptBlock>]
[-Name <String>]
[-Credential <PSCredential>]
[-Authentication <AuthenticationMechanism>]
[-WorkingDirectory <String>]
[-RunAs32]
[-PSVersion <Version>]
[-InputObject <PSObject>]
[-ArgumentList <Object[]>]
[<CommonParameters>]
DefinitionName
Start-Job
[-DefinitionName] <String>
[[-DefinitionPath] <String>]
[[-Type] <String>]
[-WorkingDirectory <String>]
[<CommonParameters>]
FilePathComputerName
Start-Job
[-FilePath] <String>
[[-InitializationScript] <ScriptBlock>]
[-Name <String>]
[-Credential <PSCredential>]
[-Authentication <AuthenticationMechanism>]
[-WorkingDirectory <String>]
[-RunAs32]
[-PSVersion <Version>]
[-InputObject <PSObject>]
[-ArgumentList <Object[]>]
[<CommonParameters>]
LiteralFilePathComputerName
Start-Job
[[-InitializationScript] <ScriptBlock>]
-LiteralPath <String>
[-Name <String>]
[-Credential <PSCredential>]
[-Authentication <AuthenticationMechanism>]
[-WorkingDirectory <String>]
[-RunAs32]
[-PSVersion <Version>]
[-InputObject <PSObject>]
[-ArgumentList <Object[]>]
[<CommonParameters>]
Description
Start-Job cmdlet'i 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 Receive-Job cmdlet'ini kullanın. 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 uzak bilgisayarda bir Invoke-Command komutu çalıştırmak için Start-Job cmdlet'ini kullanı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şlatabilir. İşleri özel türlerle başlatmak için Start-Job kullanma hakkında bilgi için iş türü özelliğinin yardım belgelerine bakın.
PowerShell 6.0'dan itibaren ampersand işareti (&) arka plan operatörünü kullanarak işler başlatabilirsiniz. Arka plan işlecinin işlevselliği, Start-Job'a benzer. bir işi başlatmak için her iki yöntem de bir PSRemotingJob iş nesnesi oluşturur. Ampersand işareti (&) kullanımı hakkında daha fazla bilgi için about_Operatorssayfasına bakın.
PowerShell 7, bir arka plan işinin ilk çalışma dizinini belirten WorkingDirectory parametresini kullanıma sunar. Parametre belirtilmezse, Start-Job, işi başlatan çağıranın geçerli çalışma dizini olarak varsayılır.
Uyarı
Start-Job ile işlem dışı arka plan işi oluşturma, PowerShell'in PowerShell Azure İşlevleri gibi diğer uygulamalarda barındırıldığı senaryoda desteklenmez.
tr-TR: Bu tasarım gereğidir çünkü Start-Job, işlem dışı çalışan bir arka plan işi başlatmak için pwsh altında bulunabilecek $PSHOME yürütülebilir dosyasına bağımlıdır. Ancak bir uygulama PowerShell'i barındırıyor olduğunda, doğrudan PowerShell NuGet SDK paketlerini kullanır ve pwsh birlikte gönderilmez.
Bu senaryodaki yedek, ThreadJobStart-ThreadJob.
Ö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 için Get-Process parametresini kullanır. PowerShell işlemlerini bulmak için Adı parametresi belirtir, pwsh. İş bilgileri görüntülenir ve iş arka planda çalışırken PowerShell bir istem döndürür.
Çalışmanın çıktısını görüntülemek için Receive-Job cmdlet'ini 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 görevini başlatmak üzere ampersand (&) arka plan işleci kullanılır. İş, Örnek 1'deki Start-Job ile aynı sonucu verir.
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 belirtmek için pwsh parametresini kullanır. Ve işareti (&), komutu bir 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.
Çalışmanın çıktısını görüntülemek için Receive-Job cmdlet'ini kullanın. Örneğin, Receive-Job -Id 5.
Örnek 3: Invoke-Command kullanarak iş başlatma
Bu örnek, birden çok bilgisayarda bir görevi yürütü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
Invoke-Command kullanan bir iş oluşturulur ve $jobWRM değişkeninde depolanır.
Invoke-Command, işin çalıştırıldığı bilgisayarları belirtmek için ComputerName parametresini kullanır.
Get-Content, C:\Servers.txt dosyasından sunucu adlarını alır.
ScriptBlock parametresi, Get-ServiceWinRM hizmetini alan bir komut belirtir.
JobName parametresi, WinRMişi için kolay bir ad belirtir.
ThrottleLimit parametresi eşzamanlı komut sayısını 16 ile sınırlar.
AsJob parametresi, komutu sunucularda ç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ü almak için Get-WinEvent belirten komutu çalıştırmak üzere ScriptBlock parametresini kullanır.
Kimlik Bilgisi parametresi, bilgisayarda işi çalıştırmak için izne sahip etki alanı kullanıcı hesabını belirtir. İş nesnesi $j değişkeninde depolanır.
$j değişkenindeki nesnesi Select-Objectişlem hattına gönderilir.
Özelliği parametresi, iş nesnesinin tüm özelliklerini görüntülemek için bir yıldız işareti (*) belirtir.
Örnek 5: Arka planda bir betiği iş olarak ç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 süreç elde etme
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-Job, Adı parametresini PShellJob adlı kolay bir iş ismi belirtmek için kullanır.
ScriptBlock parametresi, Get-Processadlı işlemleri almak için powershell belirtir.
Örnek 7: Arka plan işi kullanarak veri toplama ve kaydetme
Bu örnek, büyük miktarda harita verisi toplayan ve ardından .tif bir dosyaya kaydeden bir iş başlatır.
Start-Job -Name GetMappingFiles -InitializationScript {Import-Module -Name MapFunctions} -ScriptBlock {
Get-Map -Name * | Set-Content -Path D:\Maps.tif }
Start-Job anlaşılır bir iş adı belirtmek için Adı parametresini kullanır GetMappingFiles.
InitializationScript parametresi, MapFunctions modülünü içeri aktaran bir betik bloğu çalıştırır.
ScriptBlock parametresi Get-Map çalıştırır ve Set-Content verileri Yol parametresi tarafından belirtilen konuma kaydeder.
Örnek 8: Bir arka plan işine giriş geçirme
Bu örnekte, giriş nesnesini işlemek için $input otomatik değişkeni kullanılır. İşin çıkışını görüntülemek için Receive-Job kullanın.
Start-Job -ScriptBlock { Get-Content -Path $input } -InputObject "C:\Servers.txt"
Receive-Job -Name Job45 -Keep
Server01
Server02
Server03
Server04
Start-Job
otomatik değişkeniyle Get-Content çalıştırmak için $input parametresini kullanır.
$input değişkeni, InputObject parametresinden nesneleri alır.
Receive-Job işi belirtmek için Name parametresini kullanır ve sonuçların çıkışını alır.
Tut parametresi iş çıkışını kaydeder ve böylece PowerShell oturumu sırasında yeniden görüntülenebilir.
Örnek 9: Arka plan işi için çalışma dizinini ayarlama
WorkingDirectory, scriptleri çalıştırabileceğiniz veya dosyaları açabileceğiniz bir görev 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 dizini C:\Test.
Start-Job işin çalışma dizinini belirtmek için WorkingDirectory parametresini kullanır.
ScriptBlock parametresi, işin çalışma dizinini görüntülemek için $PWD kullanır.
Receive-Job arka plan işinin çıktısını görüntüler.
AutoRemoveJob işi siler ve Bekle tüm sonuçlar alınana kadar komut istemini gizler.
Örnek 10: Bir dizi belirtmek için ArgumentList parametresini kullanma
Bu örnekte, bir 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
Start-Job cmdlet'i komut çalıştırmak için ScriptBlock parametresini kullanır.
Get-Process
otomatik değişkenini belirtmek için $args parametresini kullanır.
ArgumentList parametresi, işlem adları dizisini $argsgeçirir. PowerShell, pwsh ve not defteri işlem adları yerel bilgisayarda çalışan işlemlerdir.
Çalışmanın çıktısını görüntülemek için Receive-Job cmdlet'ini 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şi çalıştırmak için 5.1 değerine sahip PSVersion parametresi kullanılmaktadı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
FilePath parametresi veya ScriptBlock parametresiyle belirtilen komut için bir bağımsız değişken dizisi veya parametre değerleri belirtir.
Argümanlar, ArgumentList'e tek boyutlu bir dizi argümanı olarak geçirilmelidir. Örneğin, virgülle ayrılmış bir liste. ArgumentList'in davranışı hakkında daha fazla bilgi için about_Splattingbölümüne bakın.
Parametre özellikleri
| Tür: | Object[] |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | Argümanlar |
Parametre kümeleri
ComputerName
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
FilePathComputerName
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
LiteralFilePathComputerName
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Authentication
Kullanıcı kimlik bilgilerinin kimliğini doğrulamak için kullanılan mekanizmayı belirtir.
Bu parametre için kabul edilebilir değerler aşağıdaki gibidir:
- Varsayılan
- Temel
- Credssp
- Özet
- Kerberos Gölü
- Anlaşma
- NegotiateWithImplicitCredential
Varsayılan değer "Default" olarak ayarlanmıştır.
CredSSP kimlik doğrulaması yalnızca Windows Vista, Windows Server 2008 ve Windows işletim sisteminin sonraki sürümlerinde kullanılabilir.
Bu parametrenin değerleri hakkında daha fazla bilgi için bkz. authenticationMechanism .
Dikkat
Kullanıcının kimlik bilgilerinin kimlik doğrulaması için uzak bir bilgisayara geçirildiği Kimlik Bilgisi Güvenlik Destek Sağlayıcısı (CredSSP) kimlik doğrulaması, uzak ağ paylaşımına erişme gibi birden fazla kaynakta kimlik doğrulaması gerektiren komutlar için tasarlanmıştır. Bu mekanizma, uzak işlemin güvenlik riskini artırır. Uzak bilgisayarın güvenliği aşılırsa, bu bilgisayara geçirilen kimlik bilgileri ağ oturumunu denetlemek için kullanılabilir.
Parametre özellikleri
| Tür: | AuthenticationMechanism |
| Default value: | Default |
| Kabul edilen değerler: | Default, Basic, Negotiate, NegotiateWithImplicitCredential, Credssp, Digest, Kerberos |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
ComputerName
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
FilePathComputerName
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
LiteralFilePathComputerName
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Credential
Bu eylemi gerçekleştirme iznine sahip bir kullanıcı hesabı belirtir. Kimlik Bilgisi parametresi belirtilmezse, komut geçerli kullanıcının kimlik bilgilerini kullanır.
User01 veya Domain01\User01gibi bir kullanıcı adı yazın veya cmdlet'i tarafından oluşturulan Get-Credential nesnesi girin. Bir kullanıcı adı yazarsanız parolayı girmeniz istenir.
Kimlik bilgileri bir PSCredential nesnesinde depolanır ve parola SecureStringolarak depolanır.
Uyarı
SecureString veri koruması hakkında daha fazla bilgi için bkz. SecureString ne kadar güvenli?.
Parametre özellikleri
| Tür: | PSCredential |
| Default value: | Current user |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
ComputerName
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
FilePathComputerName
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
LiteralFilePathComputerName
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-DefinitionName
Bu cmdlet'in başlattığı işin tanım adını belirtir. Zamanlanmış işler gibi tanım adına sahip özel iş türlerini başlatmak için bu parametreyi kullanın.
Zamanlanmış bir işin örneğini başlatmak için Start-Job kullandığınızda, iş tetikleyicilerinden veya iş seçeneklerinden bağımsız olarak iş hemen başlar. Sonuçta elde edilen iş örneği zamanlanmış bir iştir, ancak tetiklenen zamanlanmış işler gibi diske kaydedilmez. Zamanlanmış bir işte çalışan betiklerin parametrelerine değer sağlamak için ArgumentList parametresini Start-Job'de kullanamazsınız.
Bu parametre PowerShell 3.0'da kullanıma sunulmuştur.
Parametre özellikleri
| Tür: | String |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
DefinitionName
| Position: | 0 |
| Zorunlu: | True |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-DefinitionPath
Bu cmdlet'in başlattığı işin tanımının yolunu belirtir. Tanım yolunu girin. DefinitionPath ve DefinitionName parametrelerinin değerlerinin birleştirilmesi, iş tanımının tam nitelikli yoludur. Zamanlanmış işler gibi tanım yolu olan özel iş türlerini başlatmak için bu parametreyi kullanın.
Zamanlanmış işler için, DefinitionPath parametresinin değeri $HOME\AppData\Local\Windows\PowerShell\ScheduledJob.
Bu parametre PowerShell 3.0'da kullanıma sunulmuştur.
Parametre özellikleri
| Tür: | String |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
DefinitionName
| Position: | 1 |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-FilePath
Start-Job arka plan işi olarak çalışan yerel bir betik belirtir. Komut dosyasının yolunu ve dosya adını girin veya Start-Jobile bir komut dosyası yolu göndermek için işlem hattını kullanın. Betik yerel bilgisayarda veya yerel bilgisayarın erişebileceği bir klasörde olmalıdır.
Bu parametreyi kullandığınızda PowerShell, belirtilen betik dosyasının içeriğini bir betik bloğuna dönüştürür ve betik bloğunu arka plan işi olarak çalıştırır.
Parametre özellikleri
| Tür: | String |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
FilePathComputerName
| Position: | 0 |
| Zorunlu: | True |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-InitializationScript
İş başlamadan önce çalıştırılacak komutları belirtir. Betik bloğu oluşturmak için, komutları süslü parantezler içine alın ({}).
İşin çalıştığı oturumu hazırlamak için bu parametreyi kullanın. Örneğin, bunu kullanarak oturuma işlevler, ek bileşenler ve modüller ekleyebilirsiniz.
Parametre özellikleri
| Tür: | ScriptBlock |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
ComputerName
| Position: | 1 |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
FilePathComputerName
| Position: | 1 |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
LiteralFilePathComputerName
| Position: | 1 |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-InputObject
Komutun girişini belirtir. Nesneleri içeren bir değişken girin veya nesneleri oluşturan bir komut veya ifade yazın.
ScriptBlock parametresinin değerinde, giriş nesnelerini göstermek için $input otomatik değişkenini kullanın.
Parametre özellikleri
| Tür: | PSObject |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
ComputerName
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | True |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
FilePathComputerName
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | True |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
LiteralFilePathComputerName
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | True |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-LiteralPath
Bu cmdlet'in arka plan işi olarak çalıştırıldığı yerel bir betik belirtir. Yerel bilgisayarda bulunan bir betiğin yolunu girin.
Start-Job tam olarak yazıldığı gibi LiteralPath parametresinin değerini kullanır. Hiçbir karakter joker karakter olarak yorumlanmamıştır. Yol kaçış karakterleri içeriyorsa, yolu tek tırnak işaretleriyle çevreleyin. Tek tırnak işaretleri, PowerShell'in hiçbir karakteri kaçış dizisi olarak yorumlamamasını sağlar.
Parametre özellikleri
| Tür: | String |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | PSPath, LP |
Parametre kümeleri
LiteralFilePathComputerName
| Position: | Named |
| Zorunlu: | True |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Name
Yeni iş için anlamlı bir ad belirtir. adı kullanarak işi Stop-Job cmdlet'i gibi diğer iş cmdlet'lerine tanımlayabilirsiniz.
Varsayılan ad Job#'dır; burada, # her iş için artırılan bir sıra numarasıdır.
Parametre özellikleri
| Tür: | String |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
ComputerName
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | True |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
FilePathComputerName
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | True |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
LiteralFilePathComputerName
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | True |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-PSVersion
İşi çalıştırmak için kullanılacak PowerShell sürümünü belirtir. PSVersion değeri 5.1 olduğunda İş bir Windows PowerShell 5.1 oturumunda çalıştırılır. Diğer tüm değerler için iş, PowerShell'in geçerli sürümü kullanılarak çalıştırılır.
Bu parametre PowerShell 7'ye eklendi ve yalnızca Windows'da çalışır.
Parametre özellikleri
| Tür: | Version |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
ComputerName
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
FilePathComputerName
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
LiteralFilePathComputerName
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-RunAs32
PowerShell 7'nin RunAs32 parametresi, 64 bit PowerShell (pwsh) üzerinde çalışmaz.
RunAs32 64 bit PowerShell'de belirtilirse, Start-Job sonlandırıcı bir özel durum hatası oluşturur.
pwshile 32 bit PowerShell () işlemi başlatmak için 32 bit PowerShell'in yüklü olması gerekir.
32 bit PowerShell'de RunAs32, işi 64 bit işletim sisteminde bile 32 bit bir işlemde çalışmaya zorlar.
Windows 7 ve Windows Server 2008 R2'nin 64 bit sürümlerinde, Start-Job komutu RunAs32 parametresini içerdiğinde, başka bir kullanıcının kimlik bilgilerini belirtmek için Kimlik Bilgisi parametresini kullanamazsınız.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | False |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
ComputerName
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
FilePathComputerName
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
LiteralFilePathComputerName
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-ScriptBlock
Arka plan işinde çalıştırılacak komutları belirtir. Betik bloğu oluşturmak için, komutları süslü parantezler içine alın ({}).
$input parametresinin değerine erişmek için otomatik değişkenini kullanın. Bu parametre gereklidir.
Parametre özellikleri
| Tür: | ScriptBlock |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | Komut |
Parametre kümeleri
ComputerName
| Position: | 0 |
| Zorunlu: | True |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Type
Start-Jobtarafından başlatılan işler için özel türü belirtir. Zamanlanmış işler için PSScheduledJob veya iş akışları işleri için PSWorkflowJob gibi özel bir iş türü adı girin. Bu parametre standart arka plan işleri için geçerli değildir.
Bu parametre PowerShell 3.0'da kullanıma sunulmuştur.
Parametre özellikleri
| Tür: | String |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
DefinitionName
| Position: | 2 |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-WorkingDirectory
Arka plan işinin ilk çalışma dizinini belirtir. Parametre belirtilmezse, iş varsayılan konumdan çalışır. Varsayılan konum, işi başlatan çağıranın geçerli çalışma dizinidir.
Bu parametre PowerShell 7'de kullanıma sunulmuştur.
Parametre özellikleri
| Tür: | String |
| Default value: | $HOME on Unix (macOS, Linux) and $HOME\Documents on Windows |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
CommonParameters
Bu cmdlet yaygın parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters.
Girişler
String
Name özelliğine sahip bir nesneyi bu cmdlet'e Name parametresine yöneltebilirsiniz. Örneğin, bir FileInfo nesnesini Get-ChildItemüzerinden aktarabilirsiniz.
Çıkışlar
System.Management.Automation.PSRemotingJob
Bu cmdlet, başlattığı işi temsil eden bir PSRemotingJob nesnesi döndürür.
Notlar
PowerShell, Start-Jobiçin aşağıdaki diğer adları içerir:
- Tüm platformlar:
sajb
Arka planda çalıştırmak için, Start-Job geçerli oturumda kendi oturumunda çalışır.
Invoke-Command cmdlet'ini kullanarak uzak bilgisayardaki bir oturumda Start-Job komutu çalıştırdığınızda, Start-Job uzak oturumdaki bir oturumda çalışır.
