Out-Host
Mengirim output ke baris perintah.
Sintaks
All
Out-Host
[-Paging]
[-InputObject <PSObject>]
[<CommonParameters>]
Deskripsi
Cmdlet Out-Host mengirim output ke host PowerShell untuk ditampilkan. Host menampilkan output di baris perintah. Karena Out-Host adalah default, Anda tidak perlu menentukannya kecuali Anda ingin menggunakan parameternya.
Out-Host secara otomatis ditambahkan ke setiap perintah yang dijalankan. Ini meneruskan output alur ke host yang menjalankan perintah.
Out-Host mengabaikan urutan escape ANSI. Urutan escape ditangani oleh host.
Out-Host meneruskan urutan escape ANSI ke host tanpa mencoba menafsirkan atau mengubahnya.
Contoh
Contoh 1: Menampilkan output satu halaman dalam satu waktu
Contoh ini menampilkan proses sistem satu halaman pada satu waktu.
Get-Process | Out-Host -Paging
NPM(K) PM(M) WS(M) CPU(s) Id SI ProcessName
------ ----- ----- ------ -- -- -----------
30 24.12 36.95 15.86 21004 14 ApplicationFrameHost
55 24.33 60.48 10.80 12904 14 BCompare
<SPACE> next page; <CR> next line; Q quit
9 4.71 8.94 0.00 16864 14 explorer
<SPACE> next page; <CR> next line; Q quit
Get-Process mendapatkan proses sistem dan mengirim objek ke bawah alur.
Out-Host menggunakan parameter halaman untuk menampilkan satu halaman data pada satu waktu.
Contoh 2: Gunakan variabel sebagai input
Contoh ini menggunakan objek yang disimpan dalam variabel sebagai input untuk Out-Host.
$io = Get-History
Out-Host -InputObject $io
Get-History mendapatkan riwayat sesi PowerShell, dan menyimpan objek dalam variabel $io.
Out-Host menggunakan parameter InputObject untuk menentukan variabel $io dan menampilkan riwayat.
Parameter
-InputObject
Menentukan objek yang ditulis ke konsol. 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 |
Kumpulan parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | True |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-Paging
Menunjukkan bahwa Out-Host menampilkan satu halaman output pada satu waktu, dan menunggu input pengguna sebelum halaman yang tersisa ditampilkan. Secara default, semua output ditampilkan pada satu halaman. Ukuran halaman ditentukan oleh karakteristik host.
Tekan bilah Spasi untuk menampilkan halaman output berikutnya atau tombol Masukkan untuk melihat baris output berikutnya. Tekan Q untuk berhenti.
Paging mirip dengan perintah lebih.
Nota
Parameter halaman tidak didukung oleh host ISE PowerShell.
Properti parameter
| Jenis: | SwitchParameter |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
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 mengirim objek ke alur ke Out-Host.
Output
None
Out-Host tidak menghasilkan output apa pun. Ini mengirim objek ke host untuk ditampilkan.
Catatan
Parameter halaman tidak didukung oleh semua host PowerShell. Misalnya, jika Anda menggunakan parameter halaman di PowerShell ISE, kesalahan berikut ditampilkan: out-lineoutput : The method or operation is not implemented.
Cmdlet yang berisi kata kerja Out, Out-, tidak memformat objek. Mereka merender objek dan mengirimkannya ke tujuan tampilan yang ditentukan. Jika Anda mengirim objek yang tidak diformat ke cmdlet Out-, cmdlet mengirimkannya ke cmdlet pemformatan sebelum merendernya.
Cmdlet Out- tidak memiliki parameter untuk nama atau jalur file. Untuk mengirim data ke cmdlet Out-, gunakan alur untuk mengirim output perintah PowerShell ke cmdlet. Atau, Anda dapat menyimpan data dalam variabel dan menggunakan parameter InputObject untuk meneruskan data ke cmdlet.
Out-Host mengirim data, tetapi tidak menghasilkan objek output apa pun. Jika Anda menyalurkan output Out-Host ke cmdlet Get-Member, Get-Member melaporkan bahwa tidak ada objek yang ditentukan.