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 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. Ukuran halaman ditentukan oleh karakteristik host.
Setelah menghasilkan halaman pertama, perintah menunggu input pengguna sebelum halaman yang tersisa ditampilkan. Tekan Bilah Spasi untuk menampilkan halaman output berikutnya atau tombol Enter untuk melihat baris output berikutnya. Tekan Q untuk berhenti.
Menggunakan Halaman mirip dengan menggunakan perintah lainnya .
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 menyalurkan objek apa pun ke cmdlet ini.
Output
None
Cmdlet ini tidak mengembalikan output. Ini mengirim objek ke host untuk ditampilkan.
Catatan
PowerShell menyertakan alias berikut untuk Out-Host:
- Semua platform:
oh
Tidak semua host PowerShell mendukung parameter Halaman . Misalnya, jika Anda menggunakan parameter Halaman di ISE Windows PowerShell, kesalahan berikut ditampilkan:
out-lineoutput : Metode atau operasi tidak diimplementasikan.
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.
Out- Cmdlet tidak membaca input dari file. Untuk mengirim data ke Out- cmdlet, gunakan alur untuk mengirim data ke cmdlet. Atau, Anda dapat menyimpan data dalam variabel dan menggunakan parameter InputObject untuk meneruskan data ke cmdlet.
Out-Host mengirim data ke host saja. Tt tidak menghasilkan objek output ke alur. Jika Anda menyalurkan output Out-Host ke cmdlet Get-Member, Get-Member melaporkan bahwa tidak ada objek yang ditentukan.
