Out-Host (Microsoft.PowerShell.Core)

Out-Host

Modül:

Microsoft.PowerShell.Core

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

Sözdizimi

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

Tanım

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

Out-Host, yürütülen her komuta otomatik olarak eklenir. Boru hattının çıktısını komutu yürüten ana bilgisayara iletir. Out-Host, ANSI kaçış dizilerini yok sayar. Kaçış dizileri ana bilgisayar tarafından gerçekleştirilir. Out-Host, ANSI kaçış dizilerini, bunları yorumlamaya veya değiştirmeye çalışmadan ana bilgisayara aktarır.

Örnekler

Örnek 1: Çıktıyı her seferinde bir sayfa olarak görüntüleyin

Bu örnekte sistem işlemleri aynı anda bir sayfada görüntülenir.

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 ardışık düzene gönderir. Out-Host, tek seferde bir veri sayfasını görüntülemek için Paging parametresini kullanır.

Örnek 2: Bir değişkeni girdi olarak kullanma

Bu örnekte Out-Host girişi olarak bir değişkende saklanan 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 saklar. Out-Host, $io değişkenini belirtmek için InputObject parametresini kullanır ve geçmişi görüntüler.

Parametreler

-InputObject

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

Tip :

PSObject

Konum:

Adlandırılmış

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

True

Joker karakterleri kabul et:

False

-Paging

Out-Host'un her seferinde bir çıktı sayfası görüntülediğini ve kalan sayfalar görüntülenmeden önce kullanıcı girişini beklediğini belirtir. Varsayılan olarak tüm çıktılar tek bir sayfada görüntülenir. Sayfa boyutu ana bilgisayarın özelliklerine göre belirlenir.

Sonraki çıktı sayfasını görüntülemek için Boşluk çubuğuna 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.

Paging, more komutuna benzer.

Tip :

SwitchParameter

Konum:

Adlandırılmış

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

Girişler

PSObject

Bu cmdlet'e herhangi bir nesneyi aktarabilirsiniz.

Çıkışlar

Yok

Bu cmdlet hiçbir çıktı döndürmez. Nesneleri görüntülenmek üzere ana bilgisayara gönderir.

Notlar

PowerShell, Out-Host için aşağıdaki takma adları içerir:

• Tüm platformlar:

  oh

Paging parametresi tüm PowerShell ana bilgisayarları tarafından desteklenmez. Örneğin, PowerShell ISE'de Paging parametresini kullanırsanız aşağıdaki hata görüntülenir: out-lineoutput : Yöntem veya işlem uygulanmadı.

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

Out- cmdlet'lerinin adlar veya dosya yolları için parametreleri yoktur. Bir Out- cmdlet'ine veri göndermek için, bir PowerShell komutunun çıktısını cmdlet'e göndermek üzere ardışık düzeni kullanın. Veya verileri bir değişkende depolayabilir ve verileri cmdlet'e iletmek için InputObject parametresini kullanabilirsiniz.

Out-Host veri gönderir ancak herhangi bir çıktı nesnesi üretmez. Out-Host çıktısını Get-Member cmdlet'ine aktarırsanız, Get-Member hiçbir nesnenin belirtilmediğini bildirir.