Write-Output
Belirtilen nesneleri işlem hattındaki bir sonraki komuta gönderir. komut işlem hattındaki son komutsa, nesneler konsolunda görüntülenir.
Syntax
Default (Varsayılan)
Write-Output
[-InputObject] <PSObject[]>
[-NoEnumerate]
[<CommonParameters>]
Description
Cmdlet Write-Output , belirtilen nesneyi işlem hattından sonraki komuta gönderir.
komut işlem hattındaki son komutsa, nesne konsolunda görüntülenir.
Write-Output Nesneleri, "çı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 komutunu kullanın.
Bu cmdlet genellikle konsolda dizeleri ve diğer nesneleri görüntülemek için betiklerde kullanılır. için Write-Outputecho yerleşik diğer adlardan biridir ve kullanan echodiğer kabuklara benzer şekilde, varsayılan davranış çıktıyı 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 cmdlet'e sağlanan koleksiyonlar 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
$P = Get-Process
Write-Output $P
İlk komut, bilgisayarda çalışan işlemleri alır ve bunları değişkende $P saklar.
İkinci ve üçüncü komutlar, işlem nesnelerini konsolda $P görüntüler.
Örnek 2: Çıkışı başka bir cmdlet'e geçirme
Write-Output "test output" | Get-Member
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.
Örnek 3: Çıkışta numaralandırmayı gizleme
Write-Output 1,2,3 | Measure-Object
Count : 3
...
Write-Output 1,2,3 -NoEnumerate | Measure-Object
Count : 1
...
Bu komut, bir koleksiyonu veya diziyi işlem hattı aracılığıyla tek bir nesne olarak işlemek için NoEnumerate parametresini
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.
Uyarı
Bu anahtar yalnızca PowerShell Core 6.2 ve daha yeni sürümlerle düzgün çalışır. PowerShell Core'un eski sürümlerinde, bu anahtar kullanılsa bile koleksiyon numaralandırılmaya devam eder.
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.