Delen via

Out-String

  • Referentie
Module:
Microsoft.PowerShell.Utility

Hiermee worden objecten als een reeks tekenreeksen naar de host verzonden.

Syntax

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

Description

De Out-String cmdlet converteert de objecten die Windows PowerShell beheert naar een matrix met tekenreeksen. Standaard worden Out-String de tekenreeksen verzameld en geretourneerd als één tekenreeks, maar u kunt de parameter Stream gebruiken om Out-String één tekenreeks tegelijk te retourneren. Met deze cmdlet kunt u de uitvoer van tekenreeksen zoeken en bewerken, net zoals in traditionele shells wanneer objectmanipulatie minder handig is.

Voorbeelden

Voorbeeld 1: tekst als tekenreeks naar de console uitvoeren

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

Met deze opdracht wordt de inhoud van het Testfile2.txt-bestand als één tekenreeks naar de console verzonden. De cmdlet wordt gebruikt Get-Content om de inhoud van het bestand op te halen. De pijplijnoperator (|) verzendt de inhoud naar Out-String, waarmee de inhoud als tekenreeks naar de console wordt verzonden.

Voorbeeld 2: De huidige cultuur ophalen en de gegevens converteren naar tekenreeksen

De eerste opdracht maakt gebruik van de Get-Culture cmdlet om de landinstellingen op te halen. De pijplijnoperator (|) verzendt het resultaat naar de Select-Object cmdlet, die alle eigenschappen (*) selecteert van het cultuurobject dat Get-Culture is geretourneerd. Met de opdracht worden de resultaten vervolgens opgeslagen in de $C variabele.

De tweede opdracht gebruikt de Out-String cmdlet om het object CultureInfo te converteren naar een reeks tekenreeksen (één tekenreeks voor elke eigenschap). De parameter InputObject wordt gebruikt om de $C variabele door te geven aan Out-String. De parameter Width is ingesteld op 100 tekens per regel om afkapping te voorkomen.

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

Met deze opdrachten worden de landinstellingen voor de huidige gebruiker opgehaald en worden de gegevens geconverteerd naar tekenreeksen.

Voorbeeld 3: Werken met objecten

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

In dit voorbeeld ziet u het verschil tussen het werken met objecten en het werken met tekenreeksen. Met de opdracht worden aliassen weergegeven die de woordgroep 'Get-Command' bevatten. De cmdlet wordt gebruikt Get-Alias om een set AliasInfo-objecten op te halen (één voor elke alias in de huidige sessie).

De pijplijnoperator (|) verzendt de uitvoer van de Get-Alias cmdlet naar de Out-String cmdlet, die de objecten converteert naar een reeks tekenreeksen. De Stream parameter van Out-String wordt gebruikt om elke tekenreeks afzonderlijk te verzenden, in plaats van ze samen te voegen in één tekenreeks. Een andere pijplijnoperator verzendt de tekenreeksen naar de Select-String cmdlet, die overal in de tekenreeks de tekenreeksen selecteert die 'Get-Command' bevatten.

Als u de parameter Stream weglaat, worden met de opdracht alle aliassen weergegeven, omdat Select-String 'Get-Command' wordt gevonden in de enkele tekenreeks die Out-String retourneert, en de opmaakfunctie de tekenreeks als een tabel weergeeft.

Parameters

-InputObject

Hiermee geeft u de objecten die naar een tekenreeks moeten worden geschreven. Voer een variabele in die de objecten bevat of typ een opdracht of expressie waarmee de objecten worden opgehaald.

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

-Stream

Geeft aan dat de cmdlet de tekenreeksen voor elk object afzonderlijk verzendt. Standaard worden de tekenreeksen voor elk object samengevoegd en verzonden als één tekenreeks.

Als u de parameter Stream wilt gebruiken, typt -Stream u of de alias ervan, ost.

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

-Width

Hiermee geeft u het aantal tekens in elke regel van uitvoer. Eventuele extra tekens worden afgekapt, niet verpakt. De parameter Width is alleen van toepassing op objecten die worden opgemaakt. Als u deze parameter weglaat, wordt de breedte bepaald door de kenmerken van het hostprogramma. De standaardwaarde voor de Windows PowerShell-console is 80 (tekens).

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

Invoerwaarden

PSObject

U kunt objecten doorsluisen naar Out-String.

Uitvoerwaarden

String

Out-String retourneert de tekenreeks die wordt gemaakt op basis van het invoerobject.

Notities

  • De cmdlets die het werkwoord Out bevatten die geen objecten opmaken; ze worden alleen weergegeven en naar de opgegeven weergavebestemming verzonden. Als u een niet-opgemaakt object naar een Out-cmdlet verzendt, verzendt de cmdlet het naar een cmdlet voor opmaak voordat het wordt weergegeven.
  • De Out-cmdlets hebben geen parameters die namen of bestandspaden aannemen. Als u gegevens wilt verzenden naar een Out-cmdlet, gebruikt u een pijplijnoperator (|) om de uitvoer van een Windows PowerShell-opdracht naar de cmdlet te verzenden. U kunt ook gegevens opslaan in een variabele en de parameter InputObject gebruiken om de gegevens door te geven aan de cmdlet.