Dela via

Out-Host

  • Referens
Modul:
Microsoft.PowerShell.Core

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-Hostanvänder växlingsparametern 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 visar 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.

Type:PSObject
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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å blankstegsfältet 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.

Sidindelning liknar kommandot more .

Kommentar

Växlingsparametern stöds inte av PowerShell ISE-värden.

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

Indata

PSObject

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

Växlingsparametern stöds inte av alla PowerShell-värdar. Om du till exempel använder växlingsparametern i PowerShell ISE visas följande fel: out-lineoutput : The method or operation is not implemented.

De cmdletar som innehåller out-verbet , 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 Out-Host från till cmdleten Get-MemberGet-Member rapporterar du att inga objekt har angetts.