Write-Output
A megadott objektumokat az adatfolyamba írja.
Syntax
Default (Alapértelmezett)
Write-Output
[-InputObject] <PSObject[]>
[-NoEnumerate]
[<CommonParameters>]
Description
A megadott objektumokat az adatfolyamba írja. Ha Write-Output a folyamat utolsó parancsa, az objektumok megjelennek a konzolon.
Write-Output objektumokat küld az elsődleges adatfolyamnak, más néven a sikerfolyamnak. Ha hibaobjektumokat szeretne küldeni a hibastreambe, használja a Write-Error.
Ez a parancsmag általában sztringek és más objektumok megjelenítésére szolgál a szkriptekben a konzolon. Az Write-Output egyik beépített aliasa a echo, és hasonló más héjakhoz, amelyek a echo-t használják. 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. A Get-Process | Write-Output például egyenértékű a Get-Process. Vagy echo "Home directory: $HOME" így is leírható: "Home directory: $HOME".
Alapértelmezés szerint a Write-Output felsorolja egy gyűjtemény objektumait. A Write-Output azonban a gyűjteményeket egyetlen objektumként is átadhatja a folyamatnak a NoEnumerate paraméterrel.
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 $P folyamatobjektumait a konzolon.
$P = Get-Process
Write-Output $P
2. példa: Kimenet átadása másik parancsmagnak
Ez a parancs a "tesztkimenet" sztringet a Get-Member parancsmaghoz továbbítja, amely a System.String osztály tagjait jeleníti meg, bemutatva, hogy a sztring végighaladt a csővezetéken.
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 csatornán továbbkü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.
Paramétertulajdonságok
| Típus: | PSObject[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | 0 |
| Kötelező: | True |
| Folyamatból származó érték: | True |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | 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, hogy Write-Output számba adja a kimenetet. 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 -NoEnumerate) 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 Out-Default ad hozzá minden parancssor végéhez, ami enumerálást eredményez. Ha azonban a Write-Output -NoEnumerate-t egy másik parancsmagra továbbítja, a következő parancsmag megkapja a gyűjteményobjektumot, nem pedig a gyűjtemény felsorolt elemeit.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
CommonParameters
Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.
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 tartalmazza Write-Output:
Minden platform:
echo
Windows:
write
