ForEach-Object

Modul:

Microsoft.PowerShell.Core Module

Melakukan operasi terhadap setiap item dalam kumpulan objek input.

Sintaks

ScriptBlockSet (Default)

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

PropertyAndMethodSet

ForEach-Object
    [-MemberName] <String>
    [-InputObject <PSObject>]
    [-ArgumentList <Object[]>]
    [-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.

• Sintaks 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-Object beginmendukung blok , process, dan end seperti yang dijelaskan dalam about_Functions.

  Nota

  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.

• Sintaks yang disederhanakan. Dengan menggunakan sintaks yang disederhanakan, Anda menentukan properti atau nama metode objek dalam alur. ForEach-Object mengembalikan nilai properti atau metode untuk setiap objek dalam alur.

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

  Get-Process | ForEach-Object ProcessName

  Sintaks yang disederhanakan diperkenalkan di Windows PowerShell 3.0. Untuk informasi selengkapnya, lihat about_Simplified_Syntax.

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.

Get-EventLog -LogName System -Newest 1000 |
    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 menyalurkannya 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 E: drive 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 foreach alias 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

Nota

Blok skrip pertama selalu dipetakan ke begin blok, blok terakhir dipetakan ke end blok, dan dua blok tengah 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

Parameter

-ArgumentList

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

Parameter ini diperkenalkan di Windows PowerShell 3.0.

Properti parameter

Jenis:	Object[]
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False
Alias:	Argumen

Kumpulan parameter

PropertyAndMethodSet

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	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.

Properti parameter

Jenis:	ScriptBlock
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

ScriptBlockSet

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-Confirm

Meminta konfirmasi sebelum menjalankan cmdlet.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	False
Mendukung wildcard:	False
DontShow:	False
Alias:	Cf

Kumpulan parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	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.

Properti parameter

Jenis:	ScriptBlock
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

ScriptBlockSet

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	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.

Properti parameter

Jenis:	PSObject
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	True
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-MemberName

Menentukan nama properti anggota untuk mendapatkan atau metode anggota untuk dipanggil. Anggota harus menjadi anggota instans, bukan anggota statis.

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.

Properti parameter

Jenis:	String
Nilai default:	None
Mendukung wildcard:	True
DontShow:	False

Kumpulan parameter

PropertyAndMethodSet

Position:	0
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	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 tengah dipetakan ke process blok.

Properti parameter

Jenis:	ScriptBlock[]
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

ScriptBlockSet

Position:	0
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-RemainingScripts

Menentukan semua blok skrip yang tidak diambil oleh parameter Proses .

Parameter ini diperkenalkan di Windows PowerShell 3.0.

Properti parameter

Jenis:	ScriptBlock[]
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

ScriptBlockSet

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-WhatIf

Menunjukkan apa yang akan terjadi ketika cmdlet dijalankan. Cmdlet tidak dijalankan.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	False
Mendukung wildcard:	False
DontShow:	False
Alias:	wi

Kumpulan parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

CommonParameters

Cmdlet ini mendukung parameter umum: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, dan -WarningVariable. Untuk informasi selengkapnya, lihat about_CommonParameters.

Input

PSObject

Anda dapat menyalurkan objek apa pun ke cmdlet ini.

Output

PSObject

Cmdlet ini mengembalikan objek yang ditentukan oleh input.

Catatan

Windows PowerShell menyertakan alias berikut untuk ForEach-Object:

• %
• foreach

ForEach-Object Cmdlet berfungsi seperti foreach pernyataan, kecuali Anda tidak dapat menyalurkan input ke foreach pernyataan. Untuk informasi selengkapnya tentang pernyataan tersebut 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

Link Terkait

• Compare-Object
• Where-Object
• Kelompok-Objek
• Ukur-Objek
• Obyek Baru
• Pilih-Objek
• Urutkan-Objek
• Tee-Object