A megadott objektumokat a folyamat következő parancsához küldi. Ha a parancs az utolsó parancs a folyamatban, az objektumok megjelennek a konzolban.
Szintaxis
Leírás
A Write-Output parancsmag elküldi a megadott objektumot a folyamaton belül a következő parancshoz. Ha a parancs a folyamat utolsó parancsa, az objektum megjelenik a konzolon.
Write-Output objektumokat küld le az elsődleges csővezetéken, más néven “kimeneti folyam” vagy “sikeres folyamat”. Ha hibaobjektumokat szeretne küldeni a hibafutón, használja az Írási hiba elemet.
Ezt a parancsmagot általában parancsfájlok használják a karakterláncok és más objektumok megjelenítésére a konzolon. A Write-Output beépített álneveinek egyike echo, és hasonló a többi olyan héjhoz, amelyek echo, az alapértelmezett viselkedés a kimenet megjelenítése egy csővezeték végén. A PowerShellben általában nincs szükség a parancsmag használatára olyan esetekben, amikor a kimenet alapértelmezés szerint megjelenik. Például a Get-Process | Write-Output egyenértékű a Get-Process. Vagy echo "Home directory: $HOME" írható, "Home directory: $HOME".
Alapértelmezés szerint Write-Output felsorolja a parancsmag számára biztosított gyűjteményeket. A Write-Output azonban felhasználható a gyűjtemények továbbadására is a folyamat során egyetlen objektumként a NoEnumerate paraméterrel.
Példák
1. példa: Objektumok beszerzése és a konzolba írása
Az első parancs elindítja a számítógépen futó folyamatokat, és tárolja őket a $P változó.
A második és a harmadik parancs megjeleníti a folyamatobjektumokat a konzol $P fájljában.
2. példa: Kimenet átadása egy másik parancsmagra
Ez a parancs a “teszt kimenet” karakterláncot a Get-Member parancsmagra irányítja, amely a A System.String osztály tagjai, igazolva, hogy a karakterlánc átkerült a folyamat mentén.
3. példa: A kimenet felsorolásának elnyomása
Ez a parancs hozzáadja a NoEnumerate paramétert, hogy a gyűjteményt vagy tömböt egyetlen objektumként kezelje a folyamat során.
Paraméterek
Megadja azokat az objektumokat, amelyeket le kell küldeni a folyamaton. Írja be az objektumokat tartalmazó változót, vagy írja be az objektumokat beíró parancsot vagy kifejezést.
| Típus: | PSObject |
| Pozíció: | 0 |
| Alapértelmezett érték: | Nincs |
| A csővezeték bevitelének elfogadása: | Igaz |
| Helyettesítő karakterek elfogadása: | Hamis |
Alapértelmezés szerint a Write-Output A parancsmag mindig felsorolja a kimenetét. A NoEnumerate paraméterek elnyomják az alapértelmezett viselkedést, és megakadályozzák a Write-Output kimenet felsorolását. A NoEnumerate paraméternek nincs hatása, ha a parancs zárójelbe van csomagolva, mert a parentheses kényszeríti a felsorolást. Például a (Write-Output 1,2,3) még mindig felsorolja a tömböt.
Megjegyzés
Ez a kapcsoló csak a PowerShell Core 6.2 és újabb verziókkal működik megfelelően. A PowerShell Core régebbi verzióinál a gyűjtemény még ennek a kapcsolónak a használatával is fel van sorolva.
| Típus: | SwitchParameter |
| Pozíció: | Nevezett |
| Alapértelmezett érték: | Nincs |
| A csővezeték bevitelének elfogadása: | Hamis |
| Helyettesítő karakterek elfogadása: | Hamis |
Bemenetek
PSObject
Megadhatja objektumokat csatolhat a Write-Output fájlba.
Kimenetek
PSObject
Write-Output a bemenetként beküldött objektumokat adja vissza.
- about_Output_Streams
- about_Ririrection
- Tee-Object
- Write-Debug
- Írás-hiba
- Írás-Host
- Írás-információ
- Írás-Haladás
- Írás-Bővítés
- Írás-figyelmeztetés