Trimite obiectele specificate la următoarea comandă din conductă. Dacă comanda este ultima comandă din conductă, obiectele sunt afișate în consolă.
Sintaxă
Descriere
cmdlet-ul Write-Output trimite obiectul specificat pe conductă la următoarea comandă. Dacă comanda este ultima comandă din conductă, obiectul este afișat în consolă.
Write-Output trimite obiecte pe conducta principală, cunoscută și sub numele de „flux de ieșire” sau „conductă de succes”. Pentru a trimite obiecte de eroare în conducta de eroare, utilizați Write-Error.
Această cmdlet este de obicei folosită în scripturi pentru a afișa șiruri și alte obiecte pe consolă. Unul dintre pseudonimele încorporate pentru Write-Output este echo și similar cu alte cochilii care utilizează echo, comportamentul implicit este de a afișa ieșirea la sfârșitul unei conducte. În PowerShell, în general, nu este necesar să utilizați cmdlet-ul în cazurile în care ieșirea este afișată în mod implicit. De exemplu, Get-Process | Write-Output este echivalent cu Get-Process. Sau, echo "Home directory: $HOME" poate fi scris, "Home directory: $HOME".
În mod implicit, Write-Output enumeră prin colecțiile furnizate cmdletului. Cu toate acestea, Write-Output poate fi, de asemenea, utilizat pentru a transmite colecțiile în conductă ca un singur obiect cu parametrul NoEnumerate.
Exemple
Exemplul 1: Obțineți obiecte și scrieți-le în consolă
Prima comandă primește procese care rulează pe computer și le stochează în $P variabilă.
A doua și a treia comandă afișează obiectele procesului în $P pe consolă.
Exemplul 2: Treceți ieșirea către un alt cmdlet
Această comandă transmite șirul „test output” la cmdlet-ul Get-Member, care afișează membersof the System.String class, demonstrând că șirul a fost trecut de-a lungul conductei.
Exemplul 3: Suprimarea enumerării în ieșire
Această comandă adaugă parametrul NoEnumerate pentru a trata o colecție sau o matrice ca un singur obiect prin conductă.
Parametri
Specifică obiectele de trimis în jos în conductă. Introduceți o variabilă care conține obiectele sau comanda sau expresia typea care obține obiectele.
| Tip: | PSObject |
| Poziție: | 0 |
| Valoare implicită: | Niciuna |
| Acceptați intrarea conductei: | Adevărat |
| Acceptați caractere wildcard: | Fals |
În mod implicit, Write-Output cmdlet enumeră întotdeauna ieșirea sa. Parametrii NoEnumerate suprimă comportamentul implicit și împiedică Write-Output să enumere ieșirea. Parametrul NoEnumerate nu are efect dacă comanda este înfășurată între paranteze, deoarece parantezele forțează enumerarea. De exemplu, (Write-Output 1,2,3) enumeră în continuare matricea.
Notă
Acest comutator funcționează corect numai cu PowerShell Core 6.2 și mai recent. În versiunile mai vechi ale PowerShell Core, colecția este încă enumerată chiar și cu utilizarea acestui comutator.
| Tip: | SwitchParameter |
| Poziție: | Numit |
| Valoare implicită: | Niciunul |
| Acceptați intrarea conductei: | Fals |
| Acceptați caractere wildcard: | Fals |
Intrări
PSObject
Puteți trimiteți obiecte la Write-Output.
Ieșiri
PSObject
Write-Output returnează obiectele trimise ca intrare.
- about_Output_Streams
- about_Redirection
- Tee-Object
- Write-Debug
- Write-Error
- Write-Host
- Write-Information
- Write-Progress
- Write-Verbose
- Scriere-avertisment