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-Output
echo
yerleşik diğer adlardan biri ve kullanan echo
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-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-Output
noEnumerate 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-Output
yöneltebilirsiniz.
Çıkışlar
Write-Output
giriş olarak gönderilen nesneleri döndürür.