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. İşlem hattındaki son komut ise Write-Output , nesneler konsolunda görüntülenir.

Write-Outputnesneleri başarı akışı olarak da bilinen birincil işlem hattına gönderir. Hata nesnelerini hata akışına göndermek için kullanın Write-Error.

Bu cmdlet genellikle konsolda dizeleri ve diğer nesneleri görüntülemek için betiklerde kullanılır. için Write-Output yerleşik diğer adlardan biri ve echo kullanan echodiğ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-Output ile Get-Process eşdeğerdir. echo "Home directory: $HOME" Veya yazılabilir, "Home directory: $HOME".

Varsayılan olarak, Write-Output bir koleksiyondaki nesneleri numaralandırır. Ancak, Write-Output noEnumerate parametresiyle işlem hattını tek bir nesne olarak da geçirebilir.

Örnekler

Örnek 1: Nesneleri alma ve konsola yazma

Bu örnekte, cmdlet'in Get-Process sonuçları değişkeninde $P depolanır. cmdlet'i Write-Output konsoldaki $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 cmdlet'ine Get-Member aktarır ve bu dizenin işlem hattı boyunca geçirildiğini göstererek System.String sınıfının üyelerini görüntüler.

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ını aşağı göndermek için 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 her zaman çıkışını numaralandırır. NoEnumerate parametresi varsayılan davranışı gizler ve çıkışın numaralanmasını engellerWrite-Output. NoEnumerate parametresi, parantez içinde kaydırılırsa hiçbir etkisi olmaz çünkü parantezler 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. Konsolunda NoEnumerate'in etkilerini görmeye çalışmak sorunludur çünkü PowerShell her komut satırının sonuna ekler Out-Default ve bu da numaralandırmayla sonuçlanır. Ancak başka bir cmdlet'e kanal Write-Output -NoEnumerate oluşturursanız, aşağı akış cmdlet'i 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

PSObject

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

Notlar

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

  • Tüm platformlar:

    • echo

  • Windows:

    • write