Out-Host
Skickar utdata till kommandoraden.
Syntax
Out-Host
[-Paging]
[-InputObject <PSObject>]
[<CommonParameters>]
Description
Cmdleten Out-Host
skickar utdata till PowerShell-värden för visning. Värden visar utdata på kommandoraden. Eftersom Out-Host
är standard behöver du inte ange det om du inte vill använda dess parametrar.
Out-Host
läggs automatiskt till i varje kommando som körs. Den skickar utdata från pipelinen till värden som kör kommandot.
Out-Host
ignorerar ANSI-escape-sekvenser. Escape-sekvenserna hanteras av värden.
Out-Host
skickar ANSI-escape-sekvenser till värden utan att försöka tolka eller ändra dem.
Exempel
Exempel 1: Visa utdata en sida i taget
I det här exemplet visas systemprocesserna en sida i taget.
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
hämtar systemprocesserna och skickar objekten nedåt i pipelinen.
Out-Host
använder parametern Växling för att visa en sida med data i taget.
Exempel 2: Använd en variabel som indata
I det här exemplet används objekt som lagras i en variabel som indata för Out-Host
.
$io = Get-History
Out-Host -InputObject $io
Get-History
hämtar PowerShell-sessionens historik och lagrar objekten i variabeln $io
.
Out-Host
använder parametern InputObject för att ange variabeln $io
och visa historiken.
Parametrar
-InputObject
Anger de objekt som skrivs till konsolen. Ange en variabel som innehåller objekten eller skriv ett kommando eller uttryck som hämtar objekten.
Typ: | PSObject |
Position: | Named |
Standardvärde: | None |
Obligatorisk: | False |
Godkänn pipeline-indata: | True |
Godkänn jokertecken: | False |
-Paging
Anger att Out-Host
visar en sida med utdata i taget och väntar på användarindata innan de återstående sidorna visas. Som standard visas alla utdata på en enda sida. Sidstorleken bestäms av värdens egenskaper.
Tryck på blanksteg för att visa nästa sida med utdata eller Retur för att visa nästa rad med utdata. Tryck på Q för att avsluta.
Växling liknar kommandot mer.
Not
Parametern växling stöds inte av PowerShell ISE-värden.
Typ: | SwitchParameter |
Position: | Named |
Standardvärde: | None |
Obligatorisk: | False |
Godkänn pipeline-indata: | False |
Godkänn jokertecken: | False |
Indata
Du kan skicka valfritt objekt till den här cmdleten.
Utdata
None
Den här cmdleten returnerar inga utdata. Den skickar objekt till värden för visning.
Kommentarer
PowerShell innehåller följande alias för Out-Host
:
- Alla plattformar:
oh
Parametern växling stöds inte av alla PowerShell-värdar. Om du till exempel använder parametern växling i PowerShell ISE visas följande fel: out-lineoutput : The method or operation is not implemented.
De cmdletar som innehåller verbet Out, Out-
, formaterar inte objekt. De renderar objekt och skickar dem till det angivna visningsmålet. Om du skickar ett oformaterat objekt till en Out-
cmdlet skickar cmdleten det till en formaterings-cmdlet innan det återges.
Cmdletarna Out-
har inte parametrar för namn eller filsökvägar. Om du vill skicka data till en Out-
cmdlet använder du pipelinen för att skicka utdata från ett PowerShell-kommando till cmdleten. Eller så kan du lagra data i en variabel och använda parametern InputObject för att skicka data till cmdleten.
Out-Host
skickar data, men det producerar inga utdataobjekt. Om du dirigerar utdata från Out-Host
till cmdleten Get-Member
Get-Member
rapporter om att inga objekt har angetts.