Bagikan melalui

Write-Output

  • Referensi
Modul:
Microsoft.PowerShell.Utility

Menulis objek yang ditentukan ke alur.

Sintaks

Write-Output
     [-InputObject] <PSObject[]>
     [-NoEnumerate]
     [<CommonParameters>]

Deskripsi

Menulis objek yang ditentukan ke alur. Jika Write-Output adalah perintah terakhir dalam alur, objek ditampilkan di konsol.

Write-Outputmengirim objek ke alur utama, juga dikenal sebagai aliran keberhasilan. Untuk mengirim objek kesalahan ke aliran kesalahan, gunakan Write-Error.

Cmdlet ini biasanya digunakan dalam skrip untuk menampilkan string dan objek lain di konsol. Salah satu alias bawaan untuk Write-Output adalah echo dan mirip dengan shell lain yang menggunakan echo. Perilaku defaultnya adalah menampilkan output di akhir alur. Di PowerShell, umumnya tidak perlu menggunakan cmdlet dalam instans di mana output ditampilkan secara default. Misalnya, Get-Process | Write-Output sama dengan Get-Process. Atau, echo "Home directory: $HOME" dapat ditulis, "Home directory: $HOME".

Secara default, Write-Output menghitung objek dalam koleksi. Namun, Write-Output juga dapat meneruskan koleksi ke bawah alur sebagai objek tunggal dengan parameter NoEnumerate .

Contoh

Contoh 1: Mendapatkan objek dan menulisnya ke konsol

Dalam contoh ini, hasil Get-Process cmdlet disimpan dalam $P variabel. Write-Output Cmdlet menampilkan objek proses ke $P konsol.

$P = Get-Process
Write-Output $P

Contoh 2: Meneruskan output ke cmdlet lain

Perintah ini menyalurkan string "output pengujian" ke Get-Member cmdlet, yang menampilkan anggota kelas System.String , menunjukkan bahwa string diteruskan di sepanjang alur.

Write-Output "test output" | Get-Member

Contoh 3: Menekan enumerasi dalam output

Perintah ini menambahkan parameter NoEnumerate untuk memperlakukan koleksi atau array sebagai objek tunggal melalui alur.

Write-Output 1,2,3 | Measure-Object

Count    : 3
...

Write-Output 1,2,3 -NoEnumerate | Measure-Object

Count    : 1
...

Parameter

-InputObject

Menentukan objek untuk menurunkan alur. Masukkan variabel yang berisi objek, atau ketik perintah atau ekspresi yang mendapatkan objek.

Jenis:PSObject[]
Position:0
Nilai default:None
Diperlukan:True
Terima input alur:True
Terima karakter wildcard:False

-NoEnumerate

Secara default, Write-Output cmdlet selalu menghitung outputnya. Parameter NoEnumerate menekan perilaku default, dan mencegah Write-Output menghitung output. Parameter NoEnumerate tidak berpengaruh jika perintah dibungkus dalam tanda kurung, karena tanda kurung memaksa enumerasi. Misalnya, (Write-Output 1,2,3) masih menghitung array.

Parameter NoEnumerate hanya berguna dalam alur. Mencoba melihat efek NoEnumerate di konsol bermasalah karena PowerShell menambahkan Out-Default ke akhir setiap baris perintah, yang menghasilkan enumerasi. Tetapi jika Anda menyalurkan Write-Output -NoEnumerate ke cmdlet lain, cmdlet hilir menerima objek koleksi, bukan item koleksi yang dijumlahkan.

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

Input

PSObject

Anda dapat menyalurkan objek ke cmdlet ini.

Output

PSObject

Cmdlet ini mengembalikan objek yang dikirimkan sebagai input.

Catatan

PowerShell menyertakan alias berikut untuk Write-Output:

  • Semua platform:

    • echo

  • Windows:

    • write