Write-Output

Başvuru

Modül:: Microsoft.PowerShell.Utility

Belirtilen nesneleri işlem hattına yazar.

Sözdizimi

Write-Output
     [-InputObject] <PSObject[]>
     [-NoEnumerate]
     [<CommonParameters>]

Description

Belirtilen nesneleri işlem hattına yazar. Write-Output işlem hattındaki son komutsa, nesneler konsolunda görüntülenir.

, nesneleribaşarı akışı olarak da bilinen birincil işlem hattına gönderir. Hata akışına hata nesneleri göndermek için Write-Errorkullanın.

Bu cmdlet genellikle konsolda dizeleri ve diğer nesneleri görüntülemek için betiklerde kullanılır. Write-Output için yerleşik diğer adlardan biri echo ve echokullanan diğer kabuklara benzer. Varsayılan davranış, çıkışı bir işlem hattının sonunda görüntülemektir. PowerShell'de, çıkışın varsayılan olarak görüntülendiği örneklerde cmdlet'in kullanılması genellikle gerekli değildir. Örneğin, Get-Process | Write-OutputGet-Processeşdeğerdir. echo "Home directory: $HOME" veya "Home directory: $HOME"olarak yazılabilir.

Varsayılan olarak, Write-Output bir koleksiyondaki nesneleri numaralandırır. Ancak Write-Output, NoEnumerate parametresiyle koleksiyonları işlem hattına tek bir nesne olarak da gönderebilir.

Örnekler

Örnek 1: Nesneleri alma ve konsola yazma

Bu örnekte, Get-Process cmdlet'in sonuçları $P değişkeninde depolanır. Write-Output cmdlet'i, konsola $P işlem nesnelerini görüntüler.

$P = Get-Process
Write-Output $P

Örnek 2: Çıkışı başka bir cmdlet'e geçirme

Bu komut, "test çıktısı" dizesini Get-Member cmdlet'ine gönderir. Bu komut, System.String sınıfının üyelerini görüntüler ve dizenin işlem hattı boyunca geçirildiğini gösterir.

Write-Output "test output" | Get-Member

Örnek 3: Çıkışta numaralandırmayı gizleme

Bu komut, bir koleksiyonu veya diziyi işlem hattı aracılığıyla tek bir nesne olarak işlemek için NoEnumerate parametresini ekler.

Write-Output 1,2,3 | Measure-Object

Count    : 3
...

Write-Output 1,2,3 -NoEnumerate | Measure-Object

Count    : 1
...

Parametreler

-InputObject

İşlem hattına gönderilecek nesneleri belirtir. Nesneleri içeren bir değişken girin veya nesneleri alan bir komut veya ifade yazın.

Tür:	PSObject[]
Position:	0
Default value:	None
Gerekli:	True
İşlem hattı girişini kabul et:	True
Joker karakterleri kabul et:	False

-NoEnumerate

Varsayılan olarak, Write-Output cmdlet'i her zaman çıkışını numaralandırır. NoEnumerate parametresi varsayılan davranışı gizler ve Write-Output çıkışı numaralandırmasını engeller. NoEnumerate parametresinin, komut parantez içinde sarmalanırsa hiçbir etkisi olmaz çünkü parantez numaralandırmayı zorlar. Örneğin, (Write-Output 1,2,3 -NoEnumerate) yine de diziyi numaralandırır.

NoEnumerate parametresi yalnızca işlem hattı içinde kullanışlıdır. Konsolda NoEnumerate etkilerini görmeye çalışmak sorunludur çünkü PowerShell her komut satırının sonuna Out-Default ekler ve bu da numaralandırmayla sonuçlanır. Ancak Write-Output -NoEnumerate başka bir cmdlet'e aktarırsanız, alıcı cmdlet koleksiyonun numaralandırılmış öğelerini değil, koleksiyon nesnesini alır.

Tür:	SwitchParameter
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

Girişler

PSObject

Nesneleri bu cmdlet'e yöneltebilirsiniz.

Çıkışlar