Write-Output
Elküldi a megadott objektumokat a folyamat következő parancsának. Ha a parancs a folyamat utolsó parancsa, az objektumok megjelennek a konzolon.
Syntax
Default (Alapértelmezett)
Write-Output
[-InputObject] <PSObject[]>
[-NoEnumerate]
[<CommonParameters>]
Description
A Write-Output parancsmag elküldi a megadott objektumot a folyamaton a következő parancsnak. Ha a parancs a folyamat utolsó parancsa, az objektum megjelenik a konzolon.
Write-Output objektumokat küld le az elsődleges folyamatba, más néven a "kimeneti streambe" vagy a "sikeres folyamatba". Ha hibaobjektumokat szeretne küldeni a hibafolyamatba, használja a Write-Error parancsot.
Ez a parancsmag általában sztringek és más objektumok megjelenítésére szolgál a szkriptekben a konzolon.
Mivel azonban az alapértelmezett viselkedés az objektumok megjelenítése egy folyamat végén, általában nem szükséges használni a parancsmagot.
A Get-Process | Write-Output például egyenértékű a Get-Process.
Példák
1. példa: Objektumok lekérése és írása a konzolra
PS C:\> $P = Get-Process
PS C:\> Write-Output $P
PS C:\> $P
Az első parancs lekéri a számítógépen futó folyamatokat, és azokat a $P változóban tárolja.
A második és a harmadik parancs megjeleníti a folyamatobjektumokat $P a konzolon.
2. példa: Kimenet átadása másik parancsmagnak
PS C:\> Write-Output "test output" | Get-Member
Ez a parancs a "tesztkimenet" sztringet a Get-Member parancsmagra irányítja, amely megjeleníti a System.String osztály tagjait, amely azt mutatja, hogy a sztring a folyamat mentén lett átadva.
3. példa: Az enumerálás letiltása a kimenetben
PS C:\> Write-Output @(1,2,3) | measure
Count : 3
...
PS C:\> Write-Output @(1,2,3) -NoEnumerate | measure
Count : 1
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.
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éter nincs hatással azokra a gyűjteményekre, amelyeket zárójelekbe burkoló parancsokkal hoztak létre, mert a zárójelek enumerálást kényszerítenek.
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
Az objektumokat Íráskimeneti.
Kimenetek
PSObject
Write-Output a bemenetként elküldött objektumokat adja vissza.