Out-Host

Mengirim output ke baris perintah.

Sintaks

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

Deskripsi

Cmdlet Out-Host mengirimkan output ke host PowerShell untuk ditampilkan. Host menampilkan output di baris perintah. Karena Out-Host adalah defaultnya, 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 pelarian 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 $io variabel . Out-Host menggunakan 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
Accept pipeline input:True
Accept wildcard characters:False

-Paging

Menunjukkan bahwa Out-Host menampilkan satu halaman output sekaligus, 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.

Halaman mirip dengan perintah lainnya .

Catatan

Parameter Halaman tidak didukung oleh host ISE PowerShell.

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

Input

PSObject

Anda dapat mengirim objek ke bawah 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 Keluar , Out-, tidak memformat 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.

Cmdlet Out- 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 melaporkan bahwa tidak ada objek yang telah ditentukan.