Bagikan melalui

Out-Host

  • Referensi
Modul:
Microsoft.PowerShell.Core

Mengirim output ke baris perintah.

Sintaks

Out-Host
   [-Paging]
   [-InputObject <PSObject>]
   [<CommonParameters>]

Deskripsi

Out-Host Cmdlet mengirimkan output ke host PowerShell untuk ditampilkan. Host menampilkan output di baris perintah. Karena Out-Host merupakan 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-Hostmenggunakan 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 $io variabel. Out-Hostmenggunakan parameter InputObject untuk menentukan $io variabel dan menampilkan riwayat.

Parameter

-InputObject

Menentukan objek yang ditulis ke konsol. Masukkan variabel yang berisi objek, atau ketik perintah atau ekspresi yang mendapatkan objek.

Type:PSObject
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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 Enter untuk melihat baris output berikutnya. Tekan Q untuk keluar.

Penomor mirip dengan perintah lainnya.

Catatan

Parameter Halaman tidak didukung oleh host ISE PowerShell.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

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

Windows PowerShell menyertakan alias berikut untuk Out-Host:

  • oh

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 Keluar , Out-, jangan format objek. Mereka merender objek dan mengirimkannya ke tujuan tampilan yang ditentukan. Jika Anda mengirim objek yang tidak diformat ke Out- cmdlet, cmdlet mengirimkannya ke cmdlet pemformatan sebelum merendernya.

Out- Cmdlet tidak memiliki parameter untuk nama atau jalur file. Untuk mengirim data ke Out- cmdlet, 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 Get-Member cmdlet, Get-Member laporan bahwa tidak ada objek yang telah ditentukan.