Aracılığıyla paylaş

Write-Output

Modül:
Microsoft.PowerShell.Utility Module

Belirtilen nesneleri işlem hattına yazar.

Sözdizimi

Default EnterprisePublishing 

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 takma adlardan biri echo'dir ve echokullanan diğer kabuklarda da benzer bir şekilde kullanılır. 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", "Home directory: $HOME"olarak da 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.

Parametre özellikleri

Tür:

PSObject[]

Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:0
Zorunlu:True
İş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

-NoEnumerate

Varsayılan olarak, Write-Output cmdlet'i her zaman çıktısını liste halinde gösterir. 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'yi başka bir cmdlet'e aktarırsanız, sonrasında gelen cmdlet, koleksiyonun numaralandırılmış öğelerini değil, koleksiyonun kendisini alır.

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 bu cmdlet'e yöneltebilirsiniz.

Çıkışlar

PSObject

Bu cmdlet giriş olarak gönderilen nesneleri döndürür.

Notlar

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

  • Tüm platformlar:

    • echo

  • Windows:

    • write