Bagikan melalui

Write-Output

Modul:
Microsoft.PowerShell.Utility Module

Menulis objek yang ditentukan ke alur.

Sintaks

Default (Default) 

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-Output mengirim 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 setara 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 data ke dalam alur kerja sebagai objek tunggal dengan parameter NoEnumerate.

Contoh

Contoh 1: Mendapatkan objek dan menulisnya ke konsol

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

$P = Get-Process
Write-Output $P

Contoh 2: Meneruskan output ke cmdlet lain

Perintah ini menyalurkan string "output pengujian" ke cmdlet Get-Member, yang menampilkan anggota dari kelas System.String, yang membuktikan bahwa string tersebut telah diteruskan melalui pipeline.

Write-Output "test output" | Get-Member

Contoh 3: Menghilangkan enumerasi dalam keluaran

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

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

Count    : 3
...

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

Count    : 1
...

Parameter

-InputObject

Menentukan objek untuk dikirim melalui alur pemrosesan. Masukkan variabel yang berisi objek, atau ketik perintah atau ekspresi yang mendapatkan objek.

Properti parameter

Jenis:

PSObject[]

Nilai default:None
Mendukung wildcard:False
DontShow:False

Set parameter

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

-NoEnumerate

Secara default, cmdlet Write-Output 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 enumerasi paksa tanda kurung. Misalnya, (Write-Output 1,2,3 -NoEnumerate) masih menghitung array.

Parameter NoEnumerate hanya berguna dalam pipeline. 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.

Properti parameter

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

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