Write-Output

Modül:
Microsoft.PowerShell.Utility Module

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

Syntax

Default (Varsayılan) 

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.

Write-OutputNesneleri, "çıkış akışı" veya "başarı işlem hattı" olarak da bilinen birincil işlem hattına gönderir. Hata nesnelerini hata ardışık düzenine göndermek için .Write-Error

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 koleksiyon nesneleri aracılığıyla numaralandırır. Ancak, Write-OutputNoEnumerate parametresiyle koleksiyonları işlem hattından tek bir nesne olarak geçirmek için de kullanılabilir.

Ö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) 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 Write-Output'e yöneltebilirsiniz.

Çıkışlar

PSObject

Write-Output Girdi olarak gönderilen nesneleri döndürür.