ForEach-Object

Referensi

Modul:: Microsoft.PowerShell.Core

Melakukan operasi terhadap setiap item dalam kumpulan objek input.

Sintaks

ForEach-Object
            [-InputObject <PSObject>]
            [-Begin <ScriptBlock>]
            [-Process] <ScriptBlock[]>
            [-End <ScriptBlock>]
            [-RemainingScripts <ScriptBlock[]>]
            [-WhatIf]
            [-Confirm]
            [<CommonParameters>]

ForEach-Object
            [-InputObject <PSObject>]
            [-MemberName] <String>
            [-ArgumentList <Object[]>]
            [-WhatIf]
            [-Confirm]
            [<CommonParameters>]

ForEach-Object
            -Parallel <scriptblock>
            [-InputObject <psobject>]
            [-ThrottleLimit <int>]
            [-TimeoutSeconds <int>]
            [-AsJob]
            [-UseNewRunspace]
            [-WhatIf]
            [-Confirm]
            [<CommonParameters>]

Deskripsi

ForEach-Object Cmdlet melakukan operasi pada setiap item dalam kumpulan objek input. Objek input dapat disalurkan ke cmdlet atau ditentukan menggunakan parameter InputObject .

Dimulai di Windows PowerShell 3.0, ada dua cara berbeda untuk membuat ForEach-Object perintah.

Blok skrip. Anda dapat menggunakan blok skrip untuk menentukan operasi. Dalam blok skrip, gunakan $_ variabel untuk mewakili objek saat ini. Blok skrip adalah nilai parameter Proses . Blok skrip dapat berisi skrip PowerShell apa pun.

Misalnya, perintah berikut mendapatkan nilai properti ProcessName dari setiap proses di komputer.

Get-Process | ForEach-Object {$_.ProcessName}

ForEach-Objectbeginmendukung blok , process, dan end seperti yang dijelaskan dalam about_functions.

Catatan

Blok skrip berjalan dalam cakupan pemanggil. Oleh karena itu, blok memiliki akses ke variabel dalam cakupan tersebut dan dapat membuat variabel baru yang bertahan dalam cakupan tersebut setelah cmdlet selesai.
Pernyataan operasi. Anda juga dapat menulis pernyataan operasi, yang jauh lebih seperti bahasa alami. Anda dapat menggunakan pernyataan operasi untuk menentukan nilai properti atau memanggil metode. Pernyataan operasi diperkenalkan di Windows PowerShell 3.0.

Misalnya, perintah berikut juga mendapatkan nilai properti ProcessName dari setiap proses di komputer.

Get-Process | ForEach-Object ProcessName
Blok skrip yang berjalan paralel. Dimulai dengan PowerShell 7.0, set parameter ketiga tersedia yang menjalankan setiap blok skrip secara paralel. Parameter ThrottleLimit membatasi jumlah skrip paralel yang berjalan pada satu waktu. Seperti sebelumnya, gunakan $_ variabel untuk mewakili objek input saat ini di blok skrip. $using: Gunakan kata kunci untuk meneruskan referensi variabel ke skrip yang sedang berjalan.

Di PowerShell 7, runspace baru dibuat untuk setiap iterasi perulangan untuk memastikan isolasi maksimum. Ini bisa menjadi performa besar dan hit sumber daya jika pekerjaan yang Anda lakukan kecil dibandingkan dengan membuat runspace baru atau jika ada banyak iterasi yang melakukan pekerjaan yang signifikan. Pada PowerShell 7.1, runspace dari kumpulan runspace digunakan kembali secara default. Parameter ThrottleLimit mengatur ukuran kumpulan runspace. Ukuran kumpulan runspace default adalah 5. Anda masih dapat membuat runspace baru untuk setiap iterasi menggunakan sakelar UseNewRunspace .

Secara default, blokir skrip paralel menggunakan direktori kerja pemanggil saat ini yang memulai tugas paralel.

Untuk informasi selengkapnya, lihat bagian CATATAN di artikel ini.

Contoh

Contoh 1: Membagi bilangan bulat dalam array

Contoh ini mengambil array tiga bilangan bulat dan membagi masing-masing dengan 1024.

30000, 56798, 12432 | ForEach-Object -Process {$_/1024}

29.296875
55.466796875
12.140625

Contoh 2: Mendapatkan panjang semua file dalam direktori

Contoh ini memproses file dan direktori di direktori $PSHOMEpenginstalan PowerShell .

Get-ChildItem $PSHOME |
  ForEach-Object -Process {if (!$_.PSIsContainer) {$_.Name; $_.Length / 1024; " " }}

Jika objek bukan direktori, blok skrip mendapatkan nama file, membagi nilai properti Panjangnya dengan 1024, dan menambahkan spasi (" ") untuk memisahkannya dari entri berikutnya. Cmdlet menggunakan properti PSISContainer untuk menentukan apakah objek adalah direktori.

Contoh 3: Beroperasi pada peristiwa Sistem terbaru

Contoh ini menulis 1000 peristiwa terbaru dari log peristiwa Sistem ke file teks. Waktu saat ini ditampilkan sebelum dan sesudah memproses peristiwa.

$Events = Get-EventLog -LogName System -Newest 1000
$events | ForEach-Object -Begin {Get-Date} -Process {Out-File -FilePath Events.txt -Append -InputObject $_.Message} -End {Get-Date}

Get-EventLog mendapatkan 1000 peristiwa terbaru dari log peristiwa Sistem dan menyimpannya dalam $Events variabel. $Events kemudian disalurkan ke ForEach-Object cmdlet. Parameter Mulai menampilkan tanggal dan waktu saat ini. Selanjutnya, parameter Proses menggunakan Out-File cmdlet untuk membuat file teks yang bernama events.txt dan menyimpan properti pesan dari setiap peristiwa dalam file tersebut. Terakhir, parameter Akhir digunakan untuk menampilkan tanggal dan waktu setelah semua pemrosesan selesai.

Contoh 4: Mengubah nilai kunci Registri

Contoh ini mengubah nilai entri registri RemotePath di semua subkey di bawah HKCU:\Network kunci menjadi teks huruf besar.

Get-ItemProperty -Path HKCU:\Network\* |
  ForEach-Object {Set-ItemProperty -Path $_.PSPath -Name RemotePath -Value $_.RemotePath.ToUpper();}

Anda dapat menggunakan format ini untuk mengubah formulir atau konten nilai entri registri.

Setiap kunci dalam kunci Jaringan mewakili drive jaringan yang dipetakan yang terhubung kembali saat masuk. Entri RemotePath berisi jalur UNC dari drive yang tersambung. Misalnya, jika Anda memetakan drive E: ke \\Server\Share, subkunci E dibuat HKCU:\Network dengan nilai registri RemotePath diatur ke \\Server\Share.

Perintah menggunakan Get-ItemProperty cmdlet untuk mendapatkan semua subkuntah kunci Jaringan dan Set-ItemProperty cmdlet untuk mengubah nilai entri registri RemotePath di setiap kunci. Set-ItemProperty Dalam perintah, jalur adalah nilai properti PSPath dari kunci registri. Ini adalah properti objek Microsoft .NET Framework yang mewakili kunci registri, bukan entri registri. Perintah menggunakan metode ToUpper() dari nilai RemotePath , yang merupakan string REG_SZ.

Karena Set-ItemProperty mengubah properti setiap kunci, ForEach-Object cmdlet diperlukan untuk mengakses properti.

Contoh 5: Gunakan variabel otomatis $null

Contoh ini menunjukkan efek pipa $null variabel otomatis ke ForEach-Object cmdlet.

1, 2, $null, 4 | ForEach-Object {"Hello"}

Hello
Hello
Hello
Hello

Karena PowerShell memperlakukan $null sebagai tempat penampung eksplisit, ForEach-Object cmdlet menghasilkan nilai untuk $null seperti yang dilakukan untuk objek lain yang disalurkan ke dalamnya.

Contoh 6: Mendapatkan nilai properti

Contoh ini mendapatkan nilai properti Jalur dari semua modul PowerShell yang diinstal menggunakan parameter MemberName cmdlet ForEach-Object .

Get-Module -ListAvailable | ForEach-Object -MemberName Path
Get-Module -ListAvailable | Foreach Path

Perintah kedua setara dengan yang pertama. Ini menggunakan Foreach alias ForEach-Object cmdlet dan menghilangkan nama parameter MemberName , yang bersifat opsional.

ForEach-Object Cmdlet berguna untuk mendapatkan nilai properti, karena mendapatkan nilai tanpa mengubah jenis, tidak seperti cmdlet Format atau Select-Object cmdlet, yang mengubah jenis nilai properti.

Contoh 7: Membagi nama modul menjadi nama komponen

Contoh ini menunjukkan tiga cara untuk membagi dua nama modul yang dipisahkan titik menjadi nama komponennya. Perintah memanggil metode Pisahkan string. Ketiga perintah menggunakan sintaks yang berbeda, tetapi setara dan dapat dipertukarkan. Outputnya sama untuk ketiga kasus.

"Microsoft.PowerShell.Core", "Microsoft.PowerShell.Host" | ForEach-Object {$_.Split(".")}
"Microsoft.PowerShell.Core", "Microsoft.PowerShell.Host" | ForEach-Object -MemberName Split -ArgumentList "."
"Microsoft.PowerShell.Core", "Microsoft.PowerShell.Host" | Foreach Split "."

Microsoft
PowerShell
Core
Microsoft
PowerShell
Host

Perintah pertama menggunakan sintaks tradisional, yang mencakup blok skrip dan operator $_objek saat ini . Ini menggunakan sintaks titik untuk menentukan metode dan tanda kurung untuk mengapit argumen pembatas.

Perintah kedua menggunakan parameter MemberName untuk menentukan metode Split dan parameter ArgumentList untuk mengidentifikasi titik (.) sebagai pemisah pemisah.

Perintah ketiga menggunakan alias Foreach dari ForEach-Object cmdlet dan menghilangkan nama parameter MemberName dan ArgumentList , yang bersifat opsional.

Contoh 8: Menggunakan ForEach-Object dengan dua blok skrip

Dalam contoh ini, kami meneruskan dua blok skrip secara posisional. Semua blok skrip mengikat parameter Proses . Namun, mereka diperlakukan seolah-olah mereka telah diteruskan ke parameter Mulai dan Proses .

1..2 | ForEach-Object { 'begin' } { 'process' }

begin
process
process

Contoh 9: Menggunakan ForEach-Object dengan lebih dari dua blok skrip

Dalam contoh ini, kami meneruskan empat blok skrip secara posisional. Semua blok skrip mengikat parameter Proses . Namun, mereka diperlakukan seolah-olah mereka telah diteruskan ke parameter Mulai, Proses, dan Akhir .

1..2 | ForEach-Object { 'begin' } { 'process A' }  { 'process B' }  { 'end' }

begin
process A
process B
process A
process B
end

Catatan

Blok skrip pertama selalu dipetakan ke begin blok, blok terakhir dipetakan ke end blok, dan blok di antara semuanya dipetakan ke process blok.

Contoh 10: Jalankan beberapa blok skrip untuk setiap item alur

Seperti yang ditunjukkan pada contoh sebelumnya, beberapa blok skrip yang diteruskan menggunakan parameter Proses dipetakan ke parameter Mulai dan Akhir . Untuk menghindari pemetaan ini, Anda harus memberikan nilai eksplisit untuk parameter Mulai dan Akhir .

1..2 | ForEach-Object -Begin $null -Process { 'one' }, { 'two' }, { 'three' } -End $null

one
two
three
one
two
three

Contoh 11: Jalankan skrip lambat dalam batch paralel

Contoh ini menjalankan blok skrip yang mengevaluasi string dan tidur selama satu detik.

$Message = "Output:"

1..8 | ForEach-Object -Parallel {
    "$using:Message $_"
    Start-Sleep 1
} -ThrottleLimit 4

Output: 1
Output: 2
Output: 3
Output: 4
Output: 5
Output: 6
Output: 7
Output: 8

Nilai parameter ThrottleLimit diatur ke 4 sehingga input diproses dalam batch empat. Kata $using: kunci digunakan untuk meneruskan $Message variabel ke setiap blok skrip paralel.

Contoh 12: Mengambil entri log secara paralel

Contoh ini mengambil 50.000 entri log dari 5 log sistem pada komputer Windows lokal.

$logNames = 'Security','Application','System','Windows PowerShell','Microsoft-Windows-Store/Operational'

$logEntries = $logNames | ForEach-Object -Parallel {
    Get-WinEvent -LogName $_ -MaxEvents 10000
} -ThrottleLimit 5

$logEntries.Count

50000

Parameter Paralel menentukan blok skrip yang dijalankan secara paralel untuk setiap nama log input. Parameter ThrottleLimit memastikan bahwa kelima blok skrip berjalan secara bersamaan.

Contoh 13: Berjalan secara paralel sebagai pekerjaan

Contoh ini membuat pekerjaan yang menjalankan blok skrip secara paralel, dua per satu.

PS> $job = 1..10 | ForEach-Object -Parallel {
    "Output: $_"
    Start-Sleep 1
} -ThrottleLimit 2 -AsJob

PS> $job

Id     Name            PSJobTypeName   State         HasMoreData     Location      Command
--     ----            -------------   -----         -----------     --------      -------
23     Job23           PSTaskJob       Running       True            PowerShell    …

PS> $job.ChildJobs

Id     Name            PSJobTypeName   State         HasMoreData     Location      Command
--     ----            -------------   -----         -----------     --------      -------
24     Job24           PSTaskChildJob  Completed     True            PowerShell    …
25     Job25           PSTaskChildJob  Completed     True            PowerShell    …
26     Job26           PSTaskChildJob  Running       True            PowerShell    …
27     Job27           PSTaskChildJob  Running       True            PowerShell    …
28     Job28           PSTaskChildJob  NotStarted    False           PowerShell    …
29     Job29           PSTaskChildJob  NotStarted    False           PowerShell    …
30     Job30           PSTaskChildJob  NotStarted    False           PowerShell    …
31     Job31           PSTaskChildJob  NotStarted    False           PowerShell    …
32     Job32           PSTaskChildJob  NotStarted    False           PowerShell    …
33     Job33           PSTaskChildJob  NotStarted    False           PowerShell    …

Parameter ThrottleLimit membatasi jumlah blok skrip paralel yang berjalan pada satu waktu. Parameter AsJob menyebabkan ForEach-Object cmdlet mengembalikan objek pekerjaan alih-alih output streaming ke konsol. Variabel $job menerima objek pekerjaan yang mengumpulkan data output dan memantau status berjalan. Properti $job.ChildJobs berisi pekerjaan anak yang menjalankan blok skrip paralel.

Contoh 14: Menggunakan referensi variabel aman utas

Contoh ini memanggil blok skrip secara paralel untuk mengumpulkan objek Proses bernama unik.

$threadSafeDictionary = [System.Collections.Concurrent.ConcurrentDictionary[string,object]]::new()
Get-Process | ForEach-Object -Parallel {
    $dict = $using:threadSafeDictionary
    $dict.TryAdd($_.ProcessName, $_)
}

$threadSafeDictionary["pwsh"]

NPM(K)    PM(M)      WS(M)     CPU(s)      Id  SI ProcessName
 ------    -----      -----     ------      --  -- -----------
     82    82.87     130.85      15.55    2808   2 pwsh

Satu instans objek ConcurrentDictionary diteruskan ke setiap blok skrip untuk mengumpulkan objek. Karena ConcurrentDictionary aman untuk utas, aman untuk dimodifikasi oleh setiap skrip paralel. Objek non-thread-safe, seperti System.Collections.Generic.Dictionary, tidak akan aman untuk digunakan di sini.

Catatan

Contoh ini adalah penggunaan parameter Paralel yang sangat tidak efisien. Skrip hanya menambahkan objek input ke objek kamus bersamaan. Ini sepele dan tidak sepadan dengan overhead pemanggilan setiap skrip dalam utas terpisah. Berjalan ForEach-Object normal tanpa sakelar Paralel jauh lebih efisien dan lebih cepat. Contoh ini hanya dimaksudkan untuk menunjukkan cara menggunakan variabel aman utas.

Contoh 15: Menulis kesalahan dengan eksekusi paralel

Contoh ini menulis ke aliran kesalahan secara paralel, di mana urutan kesalahan tertulis acak.

1..3 | ForEach-Object -Parallel {
    Write-Error "Error: $_"
}

Write-Error: Error: 1
Write-Error: Error: 3
Write-Error: Error: 2

Contoh 16: Mengakhiri kesalahan dalam eksekusi paralel

Contoh ini menunjukkan kesalahan penghentian dalam satu blok skrip yang berjalan paralel.

1..5 | ForEach-Object -Parallel {
    if ($_ -eq 3)
    {
        throw "Terminating Error: $_"
    }

    Write-Output "Output: $_"
}

Exception: Terminating Error: 3
Output: 1
Output: 4
Output: 2
Output: 5

Output: 3 tidak pernah ditulis karena blokir skrip paralel untuk iterasi tersebut dihentikan.

Catatan

Variabel parameter umum PipelineVariable tidak didukung dalam Foreach-Object -Parallel skenario bahkan dengan $using: kata kunci.

Contoh 17: Meneruskan variabel dalam skrip paralel berlapis ScriptBlockSet

Anda dapat membuat variabel di luar Foreach-Object -Parallel blok skrip terlingkup dan menggunakannya di dalam blok skrip dengan $using kata kunci.

$test1 = 'TestA'
1..2 | Foreach-Object -Parallel {
    $using:test1
}

TestA
TestA

# You CANNOT create a variable inside a scoped scriptblock
# to be used in a nested foreach parallel scriptblock.
$test1 = 'TestA'
1..2 | Foreach-Object -Parallel {
    $using:test1
    $test2 = 'TestB'
    1..2 | Foreach-Object -Parallel {
        $using:test2
    }
}

Line |
   2 |  1..2 | Foreach-Object -Parallel {
     |         ~~~~~~~~~~~~~~~~~~~~~~~~~~
     | The value of the using variable '$using:test2' can't be retrieved because it has not been
     | set in the local session.

Blokir skrip berlapis tidak dapat mengakses $test2 variabel dan kesalahan dilemparkan.

Contoh 18: Membuat beberapa pekerjaan yang menjalankan skrip secara paralel

Parameter ThrottleLimit membatasi jumlah skrip paralel yang berjalan selama setiap instans ForEach-Object -Parallel. Ini tidak membatasi jumlah pekerjaan yang dapat dibuat saat menggunakan parameter AsJob . Karena pekerjaan itu sendiri berjalan bersamaan, dimungkinkan untuk membuat sejumlah pekerjaan paralel, masing-masing berjalan hingga jumlah batas pembatasan blokir skrip bersamaan.

$jobs = for ($i=0; $i -lt 10; $i++) {
    1..10 | ForEach-Object -Parallel {
        ./RunMyScript.ps1
    } -AsJob -ThrottleLimit 5
}

$jobs | Receive-Job -Wait

Contoh ini membuat 10 pekerjaan yang sedang berjalan. Setiap pekerjaan tidak berjalan lebih dari 5 skrip secara bersamaan. Jumlah total instans yang berjalan secara bersamaan dibatasi hingga 50 (10 pekerjaan kali ThrottleLimit 5).

Parameter

-ArgumentList

Menentukan array argumen ke panggilan metode. Untuk informasi selengkapnya tentang perilaku ArgumentList, lihat about_Splatting.

Parameter ini diperkenalkan di Windows PowerShell 3.0.

Type:	Object[]
Aliases:	Args
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AsJob

Menyebabkan pemanggilan paralel berjalan sebagai pekerjaan PowerShell. Satu objek pekerjaan dikembalikan alih-alih output dari blok skrip yang sedang berjalan. Objek pekerjaan berisi pekerjaan anak untuk setiap blok skrip paralel yang berjalan. Objek pekerjaan dapat digunakan oleh semua cmdlet pekerjaan PowerShell, untuk memantau status berjalan dan mengambil data.

Parameter ini diperkenalkan di PowerShell 7.0.

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

-Begin

Menentukan blok skrip yang berjalan sebelum cmdlet ini memproses objek input apa pun. Blok skrip ini hanya dijalankan sekali untuk seluruh alur. Untuk informasi selengkapnya tentang blokir, begin lihat about_Functions.

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

-Confirm

Meminta Anda mengonfirmasi sebelum menjalankan cmdlet.

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

-End

Menentukan blok skrip yang berjalan setelah cmdlet ini memproses semua objek input. Blok skrip ini hanya dijalankan sekali untuk seluruh alur. Untuk informasi selengkapnya tentang blokir, end lihat about_Functions.

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

-InputObject

Menentukan objek input. ForEach-Object menjalankan blok skrip atau pernyataan operasi pada setiap objek input. Masukkan variabel yang berisi objek, atau ketik perintah atau ekspresi yang mendapatkan objek.

Saat Anda menggunakan parameter InputObject dengan ForEach-Object, alih-alih hasil perintah pipa ke ForEach-Object, nilai InputObject diperlakukan sebagai satu objek. Ini benar bahkan jika nilainya adalah koleksi yang merupakan hasil dari perintah, seperti -InputObject (Get-Process). Karena InputObject tidak dapat mengembalikan properti individual dari array atau kumpulan objek, kami sarankan jika Anda menggunakan ForEach-Object untuk melakukan operasi pada kumpulan objek untuk objek yang memiliki nilai tertentu dalam properti yang ditentukan, Anda gunakan ForEach-Object dalam alur, seperti yang ditunjukkan dalam contoh dalam topik ini.

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

-MemberName

Menentukan properti untuk mendapatkan atau metode yang akan dipanggil.

Karakter kartubebas diizinkan, tetapi hanya berfungsi jika string yang dihasilkan diselesaikan ke nilai unik. Misalnya, jika Anda menjalankan Get-Process | ForEach -MemberName *Name, pola kartubebas cocok dengan lebih dari satu anggota yang menyebabkan perintah gagal.

Parameter ini diperkenalkan di Windows PowerShell 3.0.

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

-Parallel

Menentukan blok skrip yang akan digunakan untuk pemrosesan paralel objek input. Masukkan blok skrip yang menjelaskan operasi.

Parameter ini diperkenalkan di PowerShell 7.0.

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

-Process

Menentukan operasi yang dilakukan pada setiap objek input. Blok skrip ini dijalankan untuk setiap objek dalam alur. Untuk informasi selengkapnya tentang blokir, process lihat about_Functions.

Saat Anda menyediakan beberapa blok skrip ke parameter Proses , blok skrip pertama selalu dipetakan ke begin blok. Jika hanya ada dua blok skrip, blok kedua dipetakan ke process blok. Jika ada tiga blok skrip atau lebih, blok skrip pertama selalu dipetakan ke begin blok, blok terakhir dipetakan ke end blok, dan blok di antara semuanya dipetakan ke process blok.

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

-RemainingScripts

Menentukan semua blok skrip yang tidak diambil oleh parameter Proses .

Parameter ini diperkenalkan di Windows PowerShell 3.0.

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

-ThrottleLimit

Menentukan jumlah blok skrip yang berjalan secara paralel. Objek input diblokir hingga jumlah blok skrip yang sedang berjalan berada di bawah ThrottleLimit. Nilai defaultnya adalah 5.

Parameter ini diperkenalkan di PowerShell 7.0.

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

-TimeoutSeconds

Menentukan jumlah detik untuk menunggu semua input diproses secara paralel. Setelah waktu habis yang ditentukan, semua skrip yang berjalan dihentikan. Dan objek input yang tersisa untuk diproses diabaikan. Nilai 0 default menonaktifkan batas waktu, dan ForEach-Object -Parallel dapat berjalan tanpa batas waktu. Mengetik Ctrl+C di baris perintah menghentikan perintah yang sedang berjalan.ForEach-Object -Parallel Parameter ini tidak dapat digunakan bersama dengan parameter AsJob .

Parameter ini diperkenalkan di PowerShell 7.0.

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

-UseNewRunspace

Menyebabkan pemanggilan paralel membuat runspace baru untuk setiap iterasi perulangan alih-alih menggunakan kembali runspace dari kumpulan runspace.

Parameter ini diperkenalkan di PowerShell 7.1

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

-WhatIf

Menunjukkan apa yang akan terjadi jika cmdlet berjalan. Cmdlet tidak dijalankan.

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

Input

PSObject

Anda dapat menyalurkan objek apa pun ke cmdlet ini.

Output

PSObject

Cmdlet ini mengembalikan objek yang ditentukan oleh input.

Catatan

PowerShell menyertakan alias berikut untuk ForEach-Object:

Semua Platform:
- %
- foreach

ForEach-Object Cmdlet berfungsi seperti pernyataan Foreach, kecuali bahwa Anda tidak dapat menyalurkan input ke pernyataan Foreach. Untuk informasi selengkapnya tentang pernyataan Foreach , lihat about_Foreach.

Mulai dari PowerShell 4.0, Where dan ForEach metode ditambahkan untuk digunakan dengan koleksi. Anda dapat membaca selengkapnya tentang metode baru ini di sini about_arrays

Menggunakan ForEach-Object -Parallel:

Set ForEach-Object -Parallel parameter menggunakan API internal PowerShell untuk menjalankan setiap blok skrip di runspace baru. Ini secara signifikan lebih banyak overhead daripada berjalan ForEach-Object secara normal dengan pemrosesan berurutan. Penting untuk menggunakan Paralel di mana overhead berjalan secara paralel kecil dibandingkan dengan pekerjaan yang dilakukan blok skrip. Contohnya:
- Menghitung skrip intensif pada komputer multi-inti
- Skrip yang menghabiskan waktu menunggu hasil atau melakukan operasi file
Menggunakan parameter Paralel dapat menyebabkan skrip berjalan jauh lebih lambat dari biasanya. Terutama jika skrip paralel sepele. Bereksperimenlah dengan Paralel untuk menemukan di mana itu bisa bermanfaat.
Saat berjalan secara paralel, objek yang dihiasi dengan ScriptProperties atau ScriptMethods tidak dapat dijamin berfungsi dengan benar jika dijalankan di runspace yang berbeda dari skrip yang awalnya melekat padanya.

Pemanggilan skrip selalu mencoba berjalan di runspace berandanya, terlepas dari di mana pemanggilannya sebenarnya. Namun, ForEach-Object -Parallel membuat runspace sementara yang dihapus setelah digunakan, sehingga tidak ada runspace untuk skrip yang akan dijalankan lagi.

Perilaku ini dapat bekerja selama runspace beranda masih ada. Namun, Anda mungkin tidak mendapatkan hasil yang diinginkan jika skrip bergantung pada variabel eksternal yang hanya ada di runspace pemanggil dan bukan runspace beranda .
Kesalahan yang tidak mengakhiri ditulis ke aliran kesalahan cmdlet saat terjadi dalam blok skrip yang berjalan paralel. Karena urutan eksekusi blok skrip paralel tidak deterministik, urutan munculnya kesalahan dalam aliran kesalahan adalah acak. Demikian juga, pesan yang ditulis ke aliran data lain, seperti peringatan, verbose, atau informasi ditulis ke aliran data tersebut dalam urutan yang tidak ditentukan.

Mengakhiri kesalahan, seperti pengecualian, mengakhiri instans paralel individu dari blok skrip tempat terjadinya. Kesalahan penghentian dalam satu blok skrip mungkin tidak menyebabkan penghentian Foreach-Object cmdlet. Blokir skrip lainnya, berjalan secara paralel, terus berjalan kecuali mereka juga mengalami kesalahan yang mengakhiri. Kesalahan penghentian ditulis ke aliran data kesalahan sebagai ErrorRecord dengan FullyQualifiedErrorId dari PSTaskException. Mengakhiri kesalahan dapat dikonversi ke kesalahan yang tidak mengakhiri penggunaan PowerShell try/catch atau trap blok.
Variabel parameter umum PipelineVariable tidak didukung dalam skenario paralel bahkan dengan $using: kata kunci.

Penting

Set ForEach-Object -Parallel parameter menjalankan blok skrip secara paralel pada utas proses terpisah. Kata $using: kunci memungkinkan meneruskan referensi variabel dari utas pemanggilan cmdlet ke setiap utas blok skrip yang sedang berjalan. Karena blok skrip berjalan di utas yang berbeda, variabel objek yang diteruskan oleh referensi harus digunakan dengan aman. Umumnya aman untuk membaca dari objek yang dirujuk yang tidak berubah. Tetapi jika status objek sedang dimodifikasi maka Anda harus menggunakan objek aman utas, seperti .NET System.Collection.Concurrent type (Lihat Contoh 14).

ForEach-Object

Sintaks

Deskripsi

Contoh

Contoh 1: Membagi bilangan bulat dalam array

Contoh 2: Mendapatkan panjang semua file dalam direktori

Contoh 3: Beroperasi pada peristiwa Sistem terbaru

Contoh 4: Mengubah nilai kunci Registri

Contoh 5: Gunakan variabel otomatis $null

Contoh 6: Mendapatkan nilai properti

Contoh 7: Membagi nama modul menjadi nama komponen

Contoh 8: Menggunakan ForEach-Object dengan dua blok skrip

Contoh 9: Menggunakan ForEach-Object dengan lebih dari dua blok skrip

Contoh 10: Jalankan beberapa blok skrip untuk setiap item alur

Contoh 11: Jalankan skrip lambat dalam batch paralel

Contoh 12: Mengambil entri log secara paralel

Contoh 13: Berjalan secara paralel sebagai pekerjaan

Contoh 14: Menggunakan referensi variabel aman utas

Contoh 15: Menulis kesalahan dengan eksekusi paralel

Contoh 16: Mengakhiri kesalahan dalam eksekusi paralel

Contoh 17: Meneruskan variabel dalam skrip paralel berlapis ScriptBlockSet

Contoh 18: Membuat beberapa pekerjaan yang menjalankan skrip secara paralel

Parameter

-ArgumentList

-AsJob

-Begin

-Confirm

-End

-InputObject

-MemberName

-Parallel

-Process

-RemainingScripts

-ThrottleLimit

-TimeoutSeconds

-UseNewRunspace

-WhatIf

Input

Output

Catatan

Link Terkait

Saran dan Komentar

Sumber Daya Tambahan: