Lähettää määritetyt objektit putken seuraavaan komentoon. Jos komento on putken viimeinen komento, objektit näytetään konsolissa.
Syntaksi
Kuvaus
cmdlet Write-Output lähettää määritetyn objektin putkilinjaa pitkin seuraavaan komentoon. Jos komento on putkilinjan viimeinen komento, objekti näkyy konsolissa.
Write-Output lähettää objekteja ensisijaiseen putkistoon, joka tunnetaan myös nimellä ”ulostulovirta” tai ”menestysputki”. Jos haluat lähettää virheobjekteja virheputkea pitkin, käytä kirjoitusvirhettä.
Tätä cmdlet-komentoa käytetään yleensä komentosarjoissa merkkijonojen ja muiden objektien näyttämiseen konsolissa. Yksi Write-Output: n sisäänrakennetuista aliaksista on echo ja on samanlainen kuin muut kuoret, joissa käytetään echo, oletuskäyttäytyminen on näyttää lähtö putkilinjan päässä. PowerShellissä ei yleensä tarvitse käyttää cmdlet-komentoa tapauksissa, joissa lähtö näkyy oletusarvoisesti. Esimerkiksi Get-Process | Write-Output vastaa Get-Process. Tai echo "Home directory: $HOME" voidaan kirjoittaa, "Home directory: $HOME".
Oletuksena Write-Output luetellaan cmdletille toimitettujen kokoelmien kautta. Write-Output -sovellusta voidaan kuitenkin käyttää myös kokoelmien siirtämiseen putkistoon yhtenä objektina parametrilla NoEnumerate.
Esimerkkejä
Esimerkki 1: Hanki objektit ja kirjoita ne konsoliin
Ensimmäinen komento saa prosessit käyntiin tietokoneessa ja tallentaa ne $P muuttuja.
Toinen ja kolmas komento näyttävät prosessiobjektit konsolissa kohdassa $P.
Esimerkki 2: Lähtö toiseen cmdletiin
Tämä komento ohjaa ”testilähtö” -merkkijonon Get-Member cmdlet-komentoon, joka näyttää System.String-luokan jäsenet osoittavat, että merkkijono on välitetty putkilinjaa pitkin.
Esimerkki 3: Estä lähdön luettelointi
Tämä komento lisää NoEnumerate-parametrin, jotta kokoelma tai taulukko voidaan käsitellä yhtenä objektina putken läpi.
Parametrit
Määrittää putket alas lähetettävät objektit. Kirjoita muuttuja, joka sisältää objektit, tai typea-komento tai lauseke, joka saa objektit.
| Tyyppi: | PSObject |
| Sijainti: | 0 |
| Oletusarvo: | Ei mitään |
| Hyväksy putken syöttö: | True |
| Hyväksy jokerimerkit: | Väärin |
Oletuksena Write-Output cmdlet-luettelo aina sen tuotoksen. NoEnumerate-parametrit tukahduttavat oletuskäyttäytymisen ja estävät Write-Output -lukemasta lähtöä. Parametrilla NoEnumerate ei ole vaikutusta, jos komento on kääritty sulkeisiin, koska sulkeet pakottavat luettelon. Esimerkiksi (Write-Output 1,2,3) luetellaan edelleen taulukko.
Huomaa
Tämä kytkin toimii oikein vain PowerShell Core 6.2: n ja uudempien kanssa. Vanhemmissa PowerShell Core -versioissa kokoelma on edelleen luetteloitu, vaikka tätä kytkintä käytetään.
| Tyyppi: | SwitchParameter |
| Sijainti: | Nimetty |
| Oletusarvo: | Ei mitään |
| Hyväksy putken syöttö: | False |
| Hyväksy jokerimerkit: | Väärin |
Tulot
PSObject
Voit putkiobjektit Write-Output.
Lähdöt
PSObject
Write-Output palauttaa syötteenä lähetetyt objektit.
- about_Output_Streams
- about_Redirection
- Tee-Object
- Write-Debug
- Kirjoitusvirhe
- Kirjoitus-isäntä
- Kirjoitustiedot
- Kirjoitus-eteneminen
- Kirjoitustarkkuus
- Kirjoitusvaroitus