Out-Host
Kimenetet küld a parancssorba.
Syntax
All
Out-Host
[-Paging]
[-InputObject <PSObject>]
[<CommonParameters>]
Description
A Out-Host parancsmag kimenetet küld a PowerShell-gazdagépnek megjelenítésre. A gazdagép megjeleníti a kimenetet a parancssorban. Mivel Out-Host az alapértelmezett érték, csak akkor kell megadnia, ha a paramétereket szeretné használni.
Out-Host továbbítja a folyamat kimenetét a parancsot végrehajtó gazdagépnek.
Out-Host figyelmen kívül hagyja az ANSI-feloldási sorozatokat. A feloldósorozatokat a gazdagép kezeli.
Out-Host anélkül adja át az ANSI-feloldósorozatokat a gazdagépnek, hogy megpróbálná értelmezni vagy módosítani őket.
Példák
1. példa: Kimenet megjelenítése egyszerre egy oldalon
Ez a példa egyszerre egy oldalon jeleníti meg a rendszerfolyamatokat.
Get-Process | Out-Host -Paging
NPM(K) PM(M) WS(M) CPU(s) Id SI ProcessName
------ ----- ----- ------ -- -- -----------
30 24.12 36.95 15.86 21004 14 ApplicationFrameHost
55 24.33 60.48 10.80 12904 14 BCompare
<SPACE> next page; <CR> next line; Q quit
9 4.71 8.94 0.00 16864 14 explorer
<SPACE> next page; <CR> next line; Q quit
Get-Process lekéri a rendszerfolyamatokat, és elküldi az objektumokat a folyamatnak.
Out-Host a Lapozás paraméterrel egyszerre egy oldalnyi adatot jelenít meg.
2. példa: Változó használata bemenetként
Ez a példa egy változóban tárolt objektumokat használ a Out-Hostbemeneteként.
$io = Get-History
Out-Host -InputObject $io
Get-History lekéri a PowerShell-munkamenet előzményeit, és az objektumokat a $io változóban tárolja.
Out-Host az InputObject paraméter használatával adja meg a $io változót, és megjeleníti az előzményeket.
Paraméterek
-InputObject
Megadja a konzolra írt 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: | Named |
| Kötelező: | False |
| 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 |
-Paging
Azt jelzi, hogy Out-Host egyszerre egy oldalnyi kimenet jelenik meg. Az oldalméretet a gazdagép jellemzői határozzák meg.
Az első oldal megjelenítése után a parancs megvárja a felhasználói bemenetet a többi lap megjelenítése előtt. Nyomja le a szóközbillentyűt a kimenet következő oldalának megjelenítéséhez, vagy az Enter billentyűt a következő kimeneti sor megtekintéséhez. A kilépéshez nyomja le Q.
A Lapozás használata hasonló a több parancshoz.
Megjegyzés:
A Lapozás paramétert a PowerShell ISE-gazdagép nem támogatja.
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
A parancsmaghoz bármilyen objektumot csövezhet.
Kimenetek
None
Ez a parancsmag nem ad vissza kimenetet. Objektumokat küld a gazdagépnek megjelenítésre.
Jegyzetek
A PowerShell a következő aliasokat tartalmazza Out-Host:
- Minden platform:
oh
Nem minden PowerShell-gazdagép támogatja a Lapozás paramétert . Ha például a Lapozás paramétert használja a Windows PowerShell ISE-ben, a következő hiba jelenik meg:
out-lineoutput : A metódus vagy a művelet nincs implementálva.
A Out igét tartalmazó parancsmagok Out-nem formáznak objektumokat. Megjelenítik az objektumokat, és elküldik őket a megadott megjelenítési célhelyre. Ha formázatlan objektumot küld egy Out- parancsmagnak, a parancsmag a megjelenítés előtt elküldi azt egy formázási parancsmagnak.
A Out- parancsmagok nem olvasnak be bemenetet a fájlokból. Ha adatokat szeretne küldeni egy Out- parancsmagnak, a folyamat használatával küldjön adatokat a parancsmagnak. Vagy tárolhat adatokat egy változóban, és az InputObject paraméterrel továbbíthatja az adatokat a parancsmagnak.
Out-Host csak a gazdagépnek küld adatokat. A Tt nem hoz létre kimeneti objektumokat a folyamathoz. Ha a Out-Host kimenetét a Get-Member parancsmagba állítva, Get-Member azt jelenti, hogy nincs megadva objektum.