Write-Output

  • Referencia
Modul:
Microsoft.PowerShell.Utility

A megadott objektumokat a folyamatba írja.

Syntax

Write-Output
     [-InputObject] <PSObject[]>
     [-NoEnumerate]
     [<CommonParameters>]

Description

A megadott objektumokat a folyamatba írja. Ha Write-Output a folyamat utolsó parancsa, az objektumok megjelennek a konzolon.

Write-Outputobjektumokat küld az elsődleges folyamatnak, más néven a sikeres adatfolyamnak. Ha hibaobjektumokat szeretne küldeni a hibastreambe, használja a következőt Write-Error: .

Ez a parancsmag általában sztringek és más objektumok megjelenítésére szolgál a szkriptekben a konzolon. Az egyik beépített alias Write-Output a echo többi használt rendszerhéjhoz echohasonló. Az alapértelmezett viselkedés az, hogy a kimenet a folyamat végén jelenik meg. A PowerShellben általában nem szükséges a parancsmagot olyan példányokban használni, ahol a kimenet alapértelmezés szerint megjelenik. Például a Get-Process | Write-Output egyenértékű a következővel: Get-Process. echo "Home directory: $HOME" Vagy megírható. "Home directory: $HOME"

Alapértelmezés szerint Write-Output a gyűjteményben lévő objektumok számbavétele. A Write-Output gyűjteményeket azonban a NoEnumerate paraméterrel egyetlen objektumként is átadhatja a folyamatnak.

Példák

1. példa: Objektumok lekérése és írása a konzolra

Ebben a példában a Get-Process parancsmag eredményeit a $P változó tárolja. A Write-Output parancsmag megjeleníti a folyamatobjektumokat a konzolon $P .

$P = Get-Process
Write-Output $P

2. példa: Kimenet átadása másik parancsmagnak

Ez a parancs a "tesztkimenet" sztringet a Get-Member parancsmagra irányítja, amely megjeleníti a System.String osztály tagjait, és azt mutatja, hogy a sztring a folyamat mentén lett átadva.

Write-Output "test output" | Get-Member

3. példa: Az enumerálás letiltása a kimenetben

Ez a parancs hozzáadja a NoEnumerate paramétert egy gyűjtemény vagy tömb egyetlen objektumként való kezeléséhez a folyamaton keresztül.

Write-Output 1,2,3 | Measure-Object

Count    : 3
...

Write-Output 1,2,3 -NoEnumerate | Measure-Object

Count    : 1
...

Paraméterek

-InputObject

Megadja a folyamaton lefelé küldendő objektumokat. Adjon meg egy változót, amely tartalmazza az objektumokat, vagy írjon be egy parancsot vagy kifejezést, amely lekéri az objektumokat.

Type:PSObject[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-NoEnumerate

Alapértelmezés szerint a Write-Output parancsmag mindig számba adja a kimenetét. A NoEnumerate paraméter letiltja az alapértelmezett viselkedést, és megakadályozza Write-Output a kimenet számbavételét. A NoEnumerate paraméternek nincs hatása, ha a parancs zárójelbe van csomagolva, mert a zárójelek enumerálást kényszerítenek. Például (Write-Output 1,2,3) továbbra is számba adja a tömböt.

A NoEnumerate paraméter csak egy folyamaton belül hasznos. A NoEnumerate hatásainak a konzolon való megjelenítése problémás, mert a PowerShell minden parancssor végéhez hozzáadOut-Default, ami enumerálást eredményez. Ha azonban egy másik parancsmagra csövez Write-Output -NoEnumerate , az alsóbb rétegbeli parancsmag megkapja a gyűjteményobjektumot, nem pedig a gyűjtemény számba vett elemeit.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Bevitelek

PSObject

Ehhez a parancsmaghoz csövezhet objektumokat.

Kimenetek

PSObject

Ez a parancsmag a bemenetként elküldött objektumokat adja vissza.

Jegyzetek

A PowerShell a következő aliasokat Write-Outputtartalmazza:

  • Összes platform:

    • echo

  • Windows:

    • write