Aracılığıyla paylaş

Out-Host

Modül:
Microsoft.PowerShell.Core Module

Çıktıyı komut satırına gönderir.

Syntax

All 

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

Description

Out-Host cmdlet'i, çıktıyı görüntülemek üzere PowerShell konağına gönderir. Konak, çıktıyı komut satırında görüntüler. varsayılan Out-Host olduğundan, parametrelerini kullanmak istemediğiniz sürece bunu belirtmeniz gerekmez.

Out-Host işlem hattının çıkışını komutu yürüten konağa geçirir. Out-Host ANSI kaçış dizilerini yoksayar. Kaçış dizileri konak tarafından işlenir. Out-Host, ansi kaçış dizilerini yorumlamaya veya değiştirmeye çalışmadan konağa geçirir.

Örnekler

Örnek 1: Çıktıyı bir kerede bir sayfa görüntüleme

Bu örnekte sistem her seferinde bir sayfayı işler.

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 sistem işlemlerini alır ve nesneleri işlem hattına gönderir. Out-Host Disk Belleği parametresini kullanarak tek seferde bir veri sayfası görüntüler.

Örnek 2: Giriş olarak değişken kullanma

Bu örnekte, Out-Hostgirişi olarak bir değişkende depolanan nesneler kullanılır.

$io = Get-History
Out-Host -InputObject $io

Get-History PowerShell oturumunun geçmişini alır ve nesneleri $io değişkeninde depolar. Out-Host, değişkenini belirtmek ve geçmişi görüntülemek için $io parametresini kullanır.

Parametreler

-InputObject

Konsola yazılan nesneleri belirtir. Nesneleri içeren bir değişken girin veya nesneleri alan bir komut veya ifade yazın.

Parametre özellikleri

Tür:PSObject
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:True
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-Paging

Bir kerede bir çıkış sayfası görüntülendiğini Out-Host gösterir. Sayfa boyutu konağın özelliklerine göre belirlenir.

İlk sayfa çıktısını aldıktan sonra, komut kalan sayfalar görüntülenmeden önce kullanıcı girişini bekler. Çıkışın sonraki sayfasını görüntülemek için Ara Çubuğu'na veya sonraki çıktı satırını görüntülemek için Enter tuşuna basın. Çıkmak için Q tuşuna basın.

Sayfalama'yı kullanmak, more komutunu kullanmaya benzer.

Uyarı

Disk Belleği parametresi PowerShell ISE konağı tarafından desteklenmez.

Parametre özellikleri

Tür:SwitchParameter
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

CommonParameters

Bu cmdlet yaygın parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters.

Girişler

PSObject

Herhangi bir nesneyi bu cmdlet'e yöneltebilirsiniz.

Çıkışlar

None

Bu cmdlet çıkış döndürmez. Nesneleri görüntülemek üzere konağa gönderir.

Notlar

PowerShell, Out-Hostiçin aşağıdaki diğer adları içerir:

  • Tüm platformlar:
    • oh

Tüm PowerShell konakları Disk Belleği parametresini desteklemez. Örneğin, Windows PowerShell ISE'de Disk Belleği parametresini kullanırsanız aşağıdaki hata görüntülenir:

out-lineoutput: Yöntem veya işlem uygulanmaz.

Out fiilini (Out-) içeren cmdlet'ler nesneleri biçimlendirmez. Nesneleri işler ve belirtilen görüntüleme hedefine gönderirler. Out- cmdlet'ine biçimlendirilmemiş bir nesne gönderirseniz, cmdlet onu işlemeden önce bir biçimlendirme cmdlet'ine gönderir.

Cmdlet'ler Out- dosyalardan gelen girişleri okumaz. Bir Out- cmdlet'e veri göndermek için işlem hattını kullanarak cmdlet'e veri gönderin. Alternatif olarak, verileri bir değişkende depolayabilir ve verileri cmdlet'ine geçirmek için InputObject parametresini kullanabilirsiniz.

Out-Host yalnızca ana bilgisayara veri gönderir. Tt, işlem hattına çıkış nesneleri üretmez. Out-Host çıkışını Get-Member cmdlet'ine işlem hattı oluşturursanız, Get-Member hiçbir nesne belirtilmediğinden söz eder.