Bagikan melalui


Start-Job

Memulai proses latar belakang PowerShell.

Sintaks

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

Deskripsi

cmdlet Start-Job memulai pekerjaan latar belakang PowerShell di komputer lokal.

Pekerjaan latar belakang PowerShell menjalankan perintah tanpa berinteraksi dengan sesi saat ini. Saat Anda memulai pekerjaan latar belakang, objek pekerjaan segera kembali, bahkan jika pekerjaan membutuhkan waktu lama untuk menyelesaikannya. Anda dapat terus bekerja dalam sesi tanpa gangguan saat tugas berjalan.

Objek pekerjaan berisi informasi yang berguna tentang pekerjaan, tetapi tidak berisi hasil pekerjaan. Setelah pekerjaan selesai, gunakan cmdlet Receive-Job untuk mendapatkan hasil pekerjaan. Untuk informasi selengkapnya tentang pekerjaan latar belakang, lihat about_Jobs.

Untuk menjalankan pekerjaan latar belakang di komputer jarak jauh, gunakan parameter AsJob yang tersedia di banyak cmdlet, atau gunakan cmdlet Invoke-Command untuk menjalankan perintah Start-Job di komputer jarak jauh. Untuk informasi selengkapnya, lihat about_Remote_Jobs.

Mulai PowerShell 3.0, Start-Job dapat memulai instance jenis pekerjaan khusus, seperti pekerjaan terjadwal. Untuk informasi tentang cara menggunakan Start-Job untuk memulai pekerjaan dengan jenis kustom, lihat dokumen bantuan untuk fitur jenis pekerjaan.

Mulai dari PowerShell 6.0, Anda dapat memulai tugas menggunakan operator latar belakang ampersand (&). Fungsionalitas operator latar belakang mirip dengan Start-Job. Kedua metode untuk memulai pekerjaan membuat objek pekerjaan PSRemotingJob. Untuk informasi selengkapnya tentang menggunakan ampersand (&), lihat about_Operators.

PowerShell 7 memperkenalkan parameter WorkingDirectory, yang menentukan direktori kerja awal untuk suatu pekerjaan latar belakang. Jika parameter tidak ditentukan, Start-Job secara default akan ke direktori kerja yang sedang digunakan oleh pemanggil yang memulai tugas.

Nota

Membuat tugas latar belakang terpisah dengan Start-Job tidak didukung dalam skenario saat PowerShell dijalankan di aplikasi lain, seperti PowerShell Azure Functions.

Ini dirancang karena Start-Job bergantung pada eksekusi pwsh yang harus tersedia di bawah $PSHOME untuk memulai pekerjaan latar belakang di luar proses, tetapi ketika sebuah aplikasi menghosting PowerShell, aplikasi tersebut langsung menggunakan paket PowerShell NuGet SDK dan tidak akan menyertakan pwsh.

Pengganti dalam skenario tersebut adalah Start-ThreadJob dari modul ThreadJob.

Contoh

Contoh 1: Memulai pekerjaan latar belakang

Contoh ini memulai pekerjaan latar belakang yang berjalan di komputer lokal.

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 menggunakan parameter ScriptBlock untuk menjalankan Get-Process sebagai pekerjaan latar belakang. Parameter Nama menentukan untuk menemukan proses PowerShell, pwsh. Informasi pekerjaan ditampilkan dan PowerShell kembali ke prompt saat tugas berjalan di latar belakang.

Untuk melihat output pekerjaan, gunakan cmdlet Receive-Job. Misalnya, Receive-Job -Id 1.

Contoh 2: Gunakan operator latar belakang untuk memulai pekerjaan latar belakang

Contoh ini menggunakan operator latar belakang ampersand (&) untuk memulai pekerjaan latar belakang di komputer lokal. Tugas mendapatkan hasil yang sama dengan Start-Job pada Contoh 1.

Get-Process -Name pwsh &

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

Get-Process menggunakan parameter Nama untuk menentukan proses PowerShell, pwsh. Ampersand (&) menjalankan perintah sebagai pekerjaan latar belakang. Informasi pekerjaan ditampilkan dan PowerShell kembali ke prompt saat tugas berjalan di latar belakang.

Untuk melihat output pekerjaan, gunakan cmdlet Receive-Job. Misalnya, Receive-Job -Id 5.

Contoh 3: Memulai pekerjaan menggunakan Invoke-Command

Contoh ini menjalankan pekerjaan di beberapa komputer. Pekerjaan disimpan dalam variabel dan dijalankan dengan menggunakan nama variabel pada baris perintah PowerShell.

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

Pekerjaan yang menggunakan Invoke-Command dibuat dan disimpan dalam variabel $jobWRM. Invoke-Command menggunakan parameter ComputerName untuk menentukan komputer tempat pekerjaan berjalan. Get-Content mendapatkan nama server dari file C:\Servers.txt.

Parameter ScriptBlock menentukan perintah yang Get-Service mendapatkan layanan WinRM. Parameter JobName menentukan nama yang mudah diingat untuk pekerjaan tersebut, WinRM. Parameter ThrottleLimit membatasi jumlah perintah bersamaan menjadi 16. Parameter AsJob memulai pekerjaan latar belakang yang menjalankan perintah di server.

Contoh 4: Mendapatkan informasi pekerjaan

Contoh ini mendapatkan informasi tentang pekerjaan dan menampilkan hasil pekerjaan lengkap yang dijalankan di komputer lokal.

$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 menggunakan parameter ScriptBlock untuk menjalankan perintah yang menentukan Get-WinEvent untuk mendapatkan log Sistem. Parameter Kredensial menentukan akun pengguna domain dengan izin untuk menjalankan pekerjaan di komputer. Objek pekerjaan disimpan dalam variabel $j.

Objek dalam variabel $j dikirimkan melalui alur ke Select-Object. Parameter Properti menentukan tanda bintang (*) untuk menampilkan semua properti objek tugas.

Contoh 5: Menjalankan skrip sebagai pekerjaan latar belakang

Dalam contoh ini, skrip di komputer lokal dijalankan sebagai pekerjaan latar belakang.

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

Start-Job menggunakan parameter FilePath untuk menentukan file skrip yang disimpan di komputer lokal.

Contoh 6: Memperoleh proses menggunakan tugas latar belakang

Contoh ini menggunakan tugas latar belakang untuk mendapatkan proses yang ditentukan berdasarkan nama.

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

Start-Job menggunakan parameter Nama untuk menentukan nama tugas ramah, PShellJob. Parameter ScriptBlock menentukan Get-Process untuk mendapatkan proses dengan nama powershell.

Contoh 7: Mengumpulkan dan menyimpan data dengan menggunakan pekerjaan latar belakang

Contoh ini memulai pekerjaan yang mengumpulkan sejumlah besar data peta lalu menyimpannya dalam file .tif.

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

Start-Job menggunakan parameter Nama untuk menentukan nama pekerjaan yang ramah, GetMappingFiles. Parameter InitializationScript menjalankan blok skrip yang mengimpor modul MapFunctions. Parameter ScriptBlock berjalan Get-Map dan Set-Content menyimpan data di lokasi yang ditentukan oleh parameter Path.

Contoh 8: Meneruskan input ke pekerjaan latar belakang

Contoh ini menggunakan variabel otomatis $input untuk memproses objek input. Gunakan Receive-Job untuk melihat output pekerjaan.

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

Server01
Server02
Server03
Server04

Start-Job menggunakan parameter ScriptBlock untuk menjalankan Get-Content dengan variabel otomatis $input. Variabel $input mendapatkan objek dari parameter InputObject. Receive-Job menggunakan parameter Nama untuk menentukan pekerjaan dan menghasilkan hasilnya. Parameter Keep menyimpan output pekerjaan sehingga dapat dilihat lagi selama sesi PowerShell.

Contoh 9: Mengatur direktori kerja untuk pekerjaan latar belakang

WorkingDirectory memungkinkan Anda menentukan direktori alternatif untuk pekerjaan tempat Anda dapat menjalankan skrip atau membuka file. Dalam contoh ini, pekerjaan latar belakang menentukan direktori kerja yang berbeda dari lokasi direktori saat ini.

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

Path
----
C:\Test\Scripts

Contoh direktori kerja saat ini adalah C:\Test. Start-Job menggunakan parameter WorkingDirectory untuk menentukan direktori kerja. Parameter ScriptBlock menggunakan $PWD untuk menampilkan direktori kerja pekerjaan. Receive-Job menampilkan output pekerjaan latar belakang. AutoRemoveJob menghapus tugas dan Tunggu menahan prompt perintah hingga semua hasil diterima.

Contoh 10: Gunakan parameter ArgumentList untuk menentukan array

Contoh ini menggunakan parameter ArgumentList untuk menentukan array argumen. Array adalah daftar nama proses yang dipisahkan koma.

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 Start-Job menggunakan parameter ScriptBlock untuk menjalankan perintah. Get-Process menggunakan parameter Nama untuk menentukan variabel otomatis $args. Parameter ArgumentList meneruskan array nama-nama proses ke $args. Nama proses powershell, pwsh, dan notepad adalah proses yang berjalan di komputer lokal.

Untuk melihat output pekerjaan, gunakan cmdlet Receive-Job. Misalnya, Receive-Job -Id 1.

Contoh 11: Menjalankan pekerjaan di Windows PowerShell 5.1

Contoh ini menggunakan parameter PSVersion dengan nilai 5,1 untuk menjalankan pekerjaan dalam sesi Windows PowerShell 5.1.

$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

Parameter

-ArgumentList

Menentukan array argumen, atau nilai parameter, untuk skrip yang ditentukan oleh parameter FilePath atau perintah yang ditentukan dengan parameter ScriptBlock.

Argumen harus diteruskan ke ArgumentList sebagai argumen array dimensi tunggal. Misalnya, daftar yang dipisahkan koma. Untuk informasi selengkapnya tentang perilaku ArgumentList , lihat about_Splatting.

Jenis:Object[]
Alias:Args
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-Authentication

Menentukan mekanisme yang digunakan untuk mengautentikasi kredensial pengguna.

Nilai yang dapat diterima untuk parameter ini adalah sebagai berikut:

  • Bawaan
  • Dasar
  • CREDSSP
  • Kunyah
  • Kerberos
  • Berunding
  • NegosiasiDenganKredensialImplisit

Nilai defaultnya adalah Default.

Autentikasi CredSSP hanya tersedia di Windows Vista, Windows Server 2008, dan versi sistem operasi Windows yang lebih baru.

Untuk informasi selengkapnya tentang nilai parameter ini, lihat AuthenticationMechanism.

Perhatian

Autentikasi Penyedia Dukungan Keamanan Kredensial (CredSSP), di mana kredensial pengguna diteruskan ke komputer jarak jauh untuk diautentikasi, dirancang untuk perintah yang memerlukan autentikasi pada lebih dari satu sumber daya, seperti mengakses berbagi jaringan jarak jauh. Mekanisme ini meningkatkan risiko keamanan operasi jarak jauh. Jika komputer jarak jauh disusupi, kredensial yang diteruskan ke komputer jarak jauh dapat digunakan untuk mengontrol sesi jaringan.

Jenis:AuthenticationMechanism
Nilai yang diterima:Default, Basic, Negotiate, NegotiateWithImplicitCredential, Credssp, Digest, Kerberos
Position:Named
Nilai default:Default
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-Credential

Menentukan akun pengguna yang memiliki izin untuk melakukan tindakan ini. Jika parameter Kredensial tidak ditentukan, perintah menggunakan kredensial pengguna saat ini.

Ketik nama pengguna, seperti User01 atau Domain01\User01, atau masukkan objek PSCredential yang dihasilkan oleh cmdlet Get-Credential. Jika Anda mengetikkan nama pengguna, Anda akan diminta untuk memasukkan kata sandi.

Kredensial disimpan dalam objek PSCredential dan kata sandi disimpan sebagai SecureString.

Nota

Untuk informasi selengkapnya tentang perlindungan data SecureString, lihat Seberapa aman SecureString?.

Jenis:PSCredential
Position:Named
Nilai default:Current user
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-DefinitionName

Menentukan nama definisi dari pekerjaan yang akan dimulai oleh cmdlet ini. Gunakan parameter ini untuk memulai jenis pekerjaan kustom yang memiliki nama definisi, seperti pekerjaan terjadwal.

Saat Anda menggunakan Start-Job untuk memulai instans pekerjaan terjadwal, pekerjaan segera dimulai, terlepas dari pemicu pekerjaan atau opsi pekerjaan. Instans pekerjaan yang dihasilkan adalah pekerjaan terjadwal, tetapi tidak disimpan ke disk seperti pekerjaan terjadwal yang dipicu. Anda tidak dapat menggunakan parameter ArgumentListStart-Job untuk menyediakan nilai parameter skrip yang berjalan dalam pekerjaan terjadwal.

Parameter ini diperkenalkan di PowerShell 3.0.

Jenis:String
Position:0
Nilai default:None
Diperlukan:True
Terima input alur:False
Terima karakter wildcard:False

-DefinitionPath

Menentukan jalur definisi untuk tugas yang dimulai oleh cmdlet ini. Masukkan jalur definisi. Perangkaian nilai parameter DefinitionPath dan DefinitionName adalah jalur definisi pekerjaan yang sepenuhnya memenuhi syarat. Gunakan parameter ini untuk memulai jenis pekerjaan kustom yang memiliki jalur definisi, seperti pekerjaan terjadwal.

Untuk pekerjaan terjadwal, nilai parameter DefinitionPath adalah $HOME\AppData\Local\Windows\PowerShell\ScheduledJob.

Parameter ini diperkenalkan di PowerShell 3.0.

Jenis:String
Position:1
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-FilePath

Menentukan skrip lokal yang dijalankan Start-Job sebagai pekerjaan latar belakang. Masukkan jalur dan nama file skrip atau gunakan alur untuk mengirim jalur skrip ke Start-Job. Skrip harus berada di komputer lokal atau dalam folder yang dapat diakses komputer lokal.

Saat Anda menggunakan parameter ini, PowerShell mengonversi konten file skrip yang ditentukan ke blok skrip dan menjalankan blok skrip sebagai pekerjaan latar belakang.

Jenis:String
Position:0
Nilai default:None
Diperlukan:True
Terima input alur:False
Terima karakter wildcard:False

-InitializationScript

Menentukan perintah yang dijalankan sebelum pekerjaan dimulai. Untuk membuat blok skrip, sertakan perintah dalam kurung kurawal ({}).

Gunakan parameter ini untuk menyiapkan sesi di mana pekerjaan akan dijalankan. Misalnya, Anda dapat menggunakannya untuk menambahkan fungsi, snap-in, dan modul ke sesi.

Jenis:ScriptBlock
Position:1
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-InputObject

Menentukan input ke perintah . Masukkan variabel yang berisi objek, atau ketik perintah atau ekspresi yang menghasilkan objek.

Dalam nilai parameter ScriptBlock, gunakan variabel otomatis $input untuk mewakili objek input.

Jenis:PSObject
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False

-LiteralPath

Menentukan skrip lokal yang dijalankan cmdlet ini sebagai pekerjaan latar belakang. Masukkan jalur skrip di komputer lokal.

Start-Job menggunakan nilai parameter LiteralPath persis seperti yang ditik. Tidak ada karakter yang ditafsirkan sebagai karakter pengganti. Jika jalur menyertakan karakter escape, bungkus jalurnya dalam tanda kutip tunggal. Tanda kutip tunggal memberi tahu PowerShell untuk tidak menginterpretasikan karakter apa pun sebagai urutan escape.

Jenis:String
Alias:PSPath, LP
Position:Named
Nilai default:None
Diperlukan:True
Terima input alur:False
Terima karakter wildcard:False

-Name

Menentukan nama yang ramah untuk pekerjaan baru. Anda dapat menggunakan nama untuk mengidentifikasi tugas ke cmdlet tugas lainnya, seperti cmdlet Stop-Job.

Nama ramah default adalah Job#, di mana # adalah angka ordinal yang bertahap untuk setiap pekerjaan.

Jenis:String
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False

-PSVersion

Menentukan versi PowerShell yang akan digunakan untuk menjalankan pekerjaan. Ketika nilai PSVersion adalah 5.1, pekerjaan dijalankan dalam sesi Windows PowerShell 5.1. Untuk nilai lain, pekerjaan dijalankan menggunakan versi PowerShell saat ini.

Parameter ini ditambahkan di PowerShell 7 dan hanya berfungsi di Windows.

Jenis:Version
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-RunAs32

Dimulai dengan PowerShell 7, parameter RunAs32 tidak berfungsi pada PowerShell 64-bit (pwsh). Jika RunAs32 ditentukan dalam PowerShell 64-bit, Start-Job memunculkan kesalahan pengecualian yang mengakhiri. Untuk memulai proses PowerShell (pwsh) 32-bit dengan RunAs32, Anda harus menginstal PowerShell 32-bit.

Dalam PowerShell 32-bit, RunAs32 memaksa pekerjaan berjalan dalam proses 32-bit, bahkan pada sistem operasi 64-bit.

Pada versi 64-bit Windows 7 dan Windows Server 2008 R2, ketika perintah Start-Job menyertakan parameter RunAs32, Anda tidak dapat menggunakan parameter Kredensial untuk menentukan kredensial pengguna lain.

Jenis:SwitchParameter
Position:Named
Nilai default:False
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-ScriptBlock

Menentukan perintah yang akan dijalankan di pekerjaan latar belakang. Untuk membuat blok skrip, sertakan perintah dalam kurung kurawal ({}). Gunakan variabel otomatis $input untuk mengakses nilai parameter InputObject. Parameter ini diperlukan.

Jenis:ScriptBlock
Alias:Command
Position:0
Nilai default:None
Diperlukan:True
Terima input alur:False
Terima karakter wildcard:False

-Type

Menentukan jenis kustom untuk tugas yang dimulai oleh Start-Job. Masukkan nama jenis pekerjaan kustom, seperti PSScheduledJob untuk pekerjaan terjadwal atau PSWorkflowJob untuk pekerjaan alur kerja. Parameter ini tidak valid untuk pekerjaan latar belakang standar.

Parameter ini diperkenalkan di PowerShell 3.0.

Jenis:String
Position:2
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-WorkingDirectory

Menentukan direktori kerja awal dari pekerjaan latar belakang. Jika parameter tidak ditentukan, pekerjaan berjalan dari lokasi default. Lokasi bawaan adalah direktori kerja pemanggil yang saat ini memulai tugas.

Parameter ini diperkenalkan di PowerShell 7.

Jenis:String
Position:Named
Nilai default:$HOME on Unix (macOS, Linux) and $HOME\Documents on Windows
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

Input

String

Anda dapat menyalurkan objek dengan properti Nama ke parameter Nama ke cmdlet ini. Misalnya, Anda dapat menyalurkan objek FileInfo dari Get-ChildItem.

Output

System.Management.Automation.PSRemotingJob

Cmdlet ini mengembalikan objek PSRemotingJob yang mewakili pekerjaan yang dimulai.

Catatan

PowerShell menyertakan alias berikut untuk Start-Job:

  • Semua platform:
    • sajb

Untuk berjalan di latar belakang, Start-Job beroperasi dalam sesinya sendiri di sesi saat ini. Saat Anda menggunakan cmdlet Invoke-Command untuk menjalankan perintah Start-Job dalam sesi di komputer jarak jauh, Start-Job berjalan dalam sesi jarak jauh tersebut.