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 yürütülen her komuta otomatik olarak eklenir. İş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

Out-Host bir kerede bir çıkış sayfası görüntülediğini ve kalan sayfalar görüntülenmeden önce kullanıcı girişini beklediğini gösterir. Varsayılan olarak, tüm çıkış tek bir sayfada görüntülenir. Sayfa boyutu konağın özelliklerine göre belirlenir.

Çıktının sonraki sayfasını görüntülemek için Boşluk çubuğuna veya çıkışın sonraki satırını görüntülemek için Enter tuşuna. Çıkmak için Q tuşuna basın.

Disk Belleği, daha fazla komutuna 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

Nesneleri işlem hattından aşağıya Out-Host.

Çıkışlar

None

Out-Host herhangi bir çıkış oluşturmaz. Nesneleri görüntülemek üzere konağa gönderir.

Notlar

Disk Belleği parametresi tüm PowerShell konakları tarafından desteklenmez. Örneğin, PowerShell ISE'de Disk Belleği parametresini kullanırsanız aşağıdaki hata görüntülenir: out-lineoutput : The method or operation is not implemented.

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.

Out- cmdlet'lerinde adlar veya dosya yolları için parametreler yoktur. bir Out- cmdlet'ine veri göndermek için işlem hattını kullanarak cmdlet'ine powershell komutunun çıkışını gönderin. Alternatif olarak, verileri bir değişkende depolayabilir ve verileri cmdlet'ine geçirmek için InputObject parametresini kullanabilirsiniz.

Out-Host veri gönderir, ancak herhangi bir çıkış nesnesi oluşturmaz. Out-Host çıkışını Get-Member cmdlet'ine işlem hattı oluşturursanız, Get-Member hiçbir nesne belirtilmediğinden söz eder.