Write-Output

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

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-Output objektumokat küld az elsődleges folyamatnak, más néven a "kimeneti streamnek" vagy a "sikeres folyamatnak". Ha hibaobjektumokat szeretne küldeni a hibafolyamatba, használja a következőt Write-Error: .

Ezt a parancsmagot általában szkriptekben használják a sztringek és más objektumok konzolon való megjelenítésére. 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 használni azokban a példányokban, 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 lehet írni, "Home directory: $HOME".

Alapértelmezés szerint Write-Output gyűjteményobjektumokon keresztül számbavételt ad. Write-Output A 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 parancsmag eredményeit Get-Process a $P változó tárolja. A Write-Output parancsmag megjeleníti a konzolon található $P folyamatobjektumokat.

$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: Enumerálás mellőzése 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
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ójelekbe van csomagolva, mert a zárójelek enumerálást kényszerítenek. Például továbbra (Write-Output 1,2,3) is enumerálja a tömböt.

A NoEnumerate paraméter csak egy folyamaton belül hasznos. A NoEnumerate hatásainak a konzolon való megtekintése problémás, mert a PowerShell minden parancssor végére kerül Out-Default , ami enumerálást eredményez. Ha azonban egy másik parancsmagra érkezik Write-Output -NoEnumerate , az alsóbb rétegbeli parancsmag megkapja a gyűjteményobjektumot, nem pedig a gyűjtemény enumerált elemeit.

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

Bevitelek

PSObject

Az objektumokat átadhatja a parancsnak Write-Output.

Kimenetek

PSObject

Write-Output A a bemenetként elküldött objektumokat adja vissza.