Megosztás a következőn keresztül:

Out-String

Modul:
Microsoft.PowerShell.Utility Module

Objektumokat küld a gazdagépnek sztringek sorozataként.

Syntax

Default (Alapértelmezett) 

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

Description

A Out-String parancsmag sztringek tömbjeként alakítja át a Windows PowerShell által kezelt objektumokat. Alapértelmezés szerint Out-String összegyűjti a sztringeket, és egyetlen sztringként adja vissza őket, de a Stream paraméterrel utasíthatja a Out-String, hogy egyszerre egy sztringet adjon vissza. Ezzel a parancsmaggal ugyanúgy kereshet és módosíthat sztringkimenetet, mint a hagyományos rendszerhéjakban, ha az objektumkezelés kevésbé kényelmes.

Példák

1. példa: Szöveg kimenete a konzolra sztringként

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

Ez a parancs egyetlen sztringként küldi el a Testfile2.txt fájl tartalmát a konzolnak. A Get-Content parancsmagot használja a fájl tartalmának lekéréséhez. A folyamatkezelő (|) elküldi a tartalmat Out-String, amely sztringként küldi el a tartalmat a konzolnak.

2. példa: Az aktuális kultúra lekérése és az adatok sztringekké alakítása

Az első parancs a Get-Culture parancsmagot használja a területi beállítások lekéréséhez. A folyamatkezelő (|) elküldi az eredményt a Select-Object parancsmagnak, amely kiválasztja a kulturális objektum összes tulajdonságát (*), amelyet Get-Culture visszaadni. A parancs ezután a $C változóban tárolja az eredményeket.

A második parancs a Out-String parancsmaggal konvertálja a CultureInfo objektumot sztringek sorozatává (minden tulajdonsághoz egy sztring). A InputObject paraméter használatával adja át a $C változót Out-String. A Szélesség paraméter soronként 100 karakterre van beállítva a csonkolás megakadályozása érdekében.

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

Ezek a parancsok lekérik az aktuális felhasználó területi beállításait, és sztringekké alakítják az adatokat.

3. példa: Objektumok használata

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

Ez a példa bemutatja az objektumok és a sztringek használata közötti különbséget. A parancs olyan aliasokat jelenít meg, amelyek tartalmazzák a "Get-Command" kifejezést. A Get-Alias parancsmaggal AliasInfo objektumokat kér le (egyet az aktuális munkamenet minden aliasához).

A folyamatkezelő (|) elküldi a Get-Alias parancsmag kimenetét a Out-String parancsmagnak, amely sztringek sorozatává alakítja az objektumokat. A Out-String paraméterével egyenként küldi el az egyes sztringeket ahelyett, hogy egyetlen sztringbe fűzné őket. Egy másik folyamatkezelő elküldi a sztringeket a Select-String parancsmagnak, amely kiválasztja a "Get-Command" karakterláncokat a sztring bármely pontján.

Ha kihagyja a Stream paramétert, a parancs megjeleníti az összes aliast, mert Select-String a "Get-Command" kifejezést abban a sztringben találja, amelyet Out-String visszaad, és a formázó táblázatként jeleníti meg a sztringet.

Paraméterek

-InputObject

Megadja a sztringbe írandó 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

-Stream

Azt jelzi, hogy a parancsmag külön-külön küldi el az egyes objektumok sztringeit. Alapértelmezés szerint az egyes objektumok sztringjei halmozódnak fel, és egyetlen sztringként lesznek elküldve.

A Stream paraméter használatához írja be -Stream vagy aliasát, ost.

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

-Width

Az egyes kimeneti sorokban szereplő karakterek számát adja meg. A további karakterek csonkolva vannak, nem burkolva. A Width paraméter csak formázott objektumokra vonatkozik. Ha kihagyja ezt a paramétert, a szélességet a gazdagépprogram jellemzői határozzák meg. A Windows PowerShell-konzol alapértelmezett értéke 80 (karakter).

Paramétertulajdonságok

Típus:Int32
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

Az objektumokat a Out-Stringis be lehet csövezni.

Kimenetek

String

Out-String a bemeneti objektumból létrehozott sztringet adja vissza.

Jegyzetek

  • A Out parancsmagokat tartalmazó parancsmagok, amelyek nem formáznak objektumokat; csak renderelik őket, és elküldik őket a megadott megjelenítési célhelyre. Ha formázatlan objektumot küld egy Out parancsmagba, a parancsmag a megjelenítés előtt elküldi azt egy formázási parancsmagnak.
  • A Out parancsmagok nem rendelkeznek olyan paraméterekkel, amelyek neveket vagy fájlelérési utakat vesznek fel. Ha adatokat szeretne küldeni egy Out parancsmagba, egy folyamatkezelővel (|) küldje el a Windows PowerShell-parancs kimenetét a parancsmagnak. Az adatokat egy változóban is tárolhatja, és az InputObject paraméterrel továbbíthatja az adatokat a parancsmagnak.