Write-Output
Belirtilen nesneleri işlem hattına yazar. İşlem hattındaki son komut ise Write-Output , nesneler konsolunda görüntülenir.
Syntax
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-Output nesneleri "çıkış akışı" veya "başarılı işlem hattı" olarak da bilinen birincil işlem hattına gönderir. Hata nesnelerini hata işlem hattına göndermek için kullanın Write-Error.
Bu cmdlet genellikle konsoldaki dizeleri ve diğer nesneleri görüntülemek için betiklerde kullanılır. için Write-Outputecho yerleşik diğer adlardan biri ve 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 koleksiyon nesneleri arasında numaralandırır. Ancak, Write-OutputnoEnumerate parametresiyle işlem hattını tek bir nesne olarak geçirmek için de kullanılabilir.
Ö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 içindeki işlem nesnelerini $P konsolunda 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 gönderir 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ı gösterme
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.
| Type: | PSObject[] |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-NoEnumerate
Varsayılan olarak, Write-Output cmdlet her zaman çıkışını numaralandırır. NoEnumerate parametresi varsayılan davranışı bastırır ve çıkışın numaralanmasını engellerWrite-Output. NoEnumerate parametresinin, parantez içinde sarmalandığında hiçbir etkisi olmaz, çünkü parantez sabit listesi 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'ın 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.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Girişler
Nesneleri öğesine Write-Outputyöneltebilirsiniz.
Çıkışlar
Write-Output giriş olarak gönderilen nesneleri döndürür.