Dela via

Out-String

  • Referens
Modul:
Microsoft.PowerShell.Utility

Skickar objekt till värden som en serie strängar.

Syntax

Out-String
   [-Stream]
   [-Width <Int32>]
   [-InputObject <PSObject>]
   [<CommonParameters>]

Description

Cmdleten Out-String konverterar de objekt som Windows PowerShell hanterar till en matris med strängar. Som standard ackumulerar Out-String strängarna och returnerar dem som en enda sträng, men du kan använda parametern Stream för att dirigera Out-String att returnera en sträng i taget. Med den här cmdleten kan du söka efter och ändra strängutdata som i traditionella gränssnitt när objektmanipulering är mindre praktiskt.

Exempel

Exempel 1: Mata ut text till konsolen som en sträng

PS C:\> Get-Content C:\test1\testfile2.txt | Out-String

Det här kommandot skickar innehållet i Testfile2.txt-filen till konsolen som en enda sträng. Den använder cmdleten Get-Content för att hämta innehållet i filen. Pipelineoperatorn (|) skickar innehållet till Out-String, som skickar innehållet till konsolen som en sträng.

Exempel 2: Hämta den aktuella kulturen och konvertera data till strängar

Det första kommandot använder cmdleten Get-Culture för att hämta de regionala inställningarna. Pipelineoperatorn (|) skickar resultatet till cmdleten Select-Object, som väljer alla egenskaper (*) för kulturobjektet som Get-Culture returnerade. Kommandot lagrar sedan resultatet i variabeln $C.

Det andra kommandot använder cmdleten Out-String för att konvertera objektet CultureInfo till en serie strängar (en sträng för varje egenskap). Den använder parametern InputObject för att skicka variabeln $C till Out-String. Parametern Width är inställd på 100 tecken per rad för att förhindra trunkering.

PS C:\> $C = Get-Culture | Select-Object *
PS C:\> Out-String -InputObject $C -Width 100

Dessa kommandon hämtar de regionala inställningarna för den aktuella användaren och konverterar data till strängar.

Exempel 3: Arbeta med objekt

PS C:\> Get-Alias | Out-String -Stream | Select-String "Get-Command"

Det här exemplet visar skillnaden mellan att arbeta med objekt och att arbeta med strängar. Kommandot visar alias som innehåller frasen "Get-Command". Den använder cmdleten Get-Alias för att hämta en uppsättning AliasInfo- objekt (ett för varje alias i den aktuella sessionen).

Pipelineoperatorn (|) skickar utdata från cmdleten Get-Alias till cmdleten Out-String, som konverterar objekten till en serie strängar. Den använder parametern Stream för Out-String för att skicka varje sträng individuellt, i stället för att sammanfoga dem till en enda sträng. En annan pipelineoperator skickar strängarna till cmdleten Select-String, som väljer strängarna som innehåller "Get-Command" var som helst i strängen.

Om du utelämnar parametern Stream visar kommandot alla alias eftersom Select-String hittar "Get-Command" i den enda sträng som Out-String returnerar, och formateren visar strängen som en tabell.

Parametrar

-InputObject

Anger de objekt som ska skrivas till en sträng. 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

-Stream

Anger att cmdleten skickar strängarna för varje objekt separat. Som standard ackumuleras strängarna för varje objekt och skickas som en enda sträng.

Om du vill använda parametern Stream skriver du -Stream eller dess alias ost.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Width

Anger antalet tecken på varje utdatarad. Eventuella ytterligare tecken trunkeras, inte omsluts. Parametern Width gäller endast för objekt som formateras. Om du utelämnar den här parametern bestäms bredden av värdprogrammets egenskaper. Standardvärdet för Windows PowerShell-konsolen är 80 (tecken).

Typ:Int32
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

PSObject

Du kan skicka objekt till Out-String.

Utdata

String

Out-String returnerar strängen som skapas från indataobjektet.

Kommentarer

  • De cmdletar som innehåller verbet Out som inte formaterar objekt. de renderar dem bara och skickar dem till det angivna visningsmålet. Om du skickar ett oformaterat objekt till en cmdlet Out skickar cmdleten det till en formaterings-cmdlet innan det återges.
  • Cmdletarna Out har inte parametrar som tar namn eller filsökvägar. Om du vill skicka data till en Ut cmdlet använder du en pipelineoperator (|) för att skicka utdata från ett Windows PowerShell-kommando till cmdleten. Du kan också lagra data i en variabel och använda parametern InputObject för att skicka data till cmdleten.