Get-FormatData

Lekéri a formázási adatokat az aktuális munkamenetben.

Syntax

Get-FormatData
   [[-TypeName] <String[]>]
   [-PowerShellVersion <Version>]
   [<CommonParameters>]

Description

A Get-FormatData parancsmag lekéri a formázási adatokat az aktuális munkamenetben.

A munkamenet formázási adatai közé tartoznak a formázási fájlokból származó Format.ps1xml adatok, például a $PSHOME könyvtárban lévők, a munkamenetbe importált modulok adatainak formázása, valamint a parancsmag használatával a Import-PSSession munkamenetbe importált parancsok adatainak formázása.

Ezzel a parancsmaggal megvizsgálhatja a formázási adatokat. Ezután a Export-FormatData parancsmaggal szerializálhatja az objektumokat, XML-fájllá alakíthatja őket, és fájlba Format.ps1xml mentheti őket.

A fájlok PowerShellben való formázásáról a about_Format.ps1xml fájlban talál további információt.

Példák

1. példa: Az összes formázási adat lekérése

Ez a példa lekéri a munkamenet összes formázási adatát.

Get-FormatData

2. példa: Formázási adatok beolvasása típusnév alapján

Ez a példa lekéri azokat a formázási adatelemeket, amelyek neve a következővel System.Management.Automation.Cmdkezdődik:

Get-FormatData -TypeName 'System.Management.Automation.Cmd*'

3. példa: Adatobjektum formázásának vizsgálata

Ez a példa bemutatja, hogyan kérhet le egy formázási adatobjektumot, és hogyan vizsgálhatja meg annak tulajdonságait.

$F = Get-FormatData -TypeName 'System.Management.Automation.Cmd*'
$F

TypeName        FormatViewDefinition
--------        --------------------
HelpInfoShort   {help , TableControl}

$F.FormatViewDefinition[0].control

Headers          : {System.Management.Automation.TableControlColumnHeader,
                   System.Management.Automation.TableControlColumnHeader,
                   System.Management.Automation.TableControlColumnHeader,
                   System.Management.Automation.TableControlColumnHeader}
Rows             : {System.Management.Automation.TableControlRow}
AutoSize         : False
HideTableHeaders : False
GroupBy          :
OutOfBand        : False

$F.FormatViewDefinition[0].control.Headers

Label       Alignment Width
-----       --------- -----
CommandType Undefined    15
Name        Undefined    50
Version     Undefined    10
Source      Undefined     0

4. példa: Formázási adatok lekérése és exportálása

Ez a példa bemutatja, hogyan használhatja Get-FormatData és Export-FormatData exportálhatja a modul által hozzáadott formázási adatokat.

$A = Get-FormatData
Import-Module bitstransfer
$B = Get-FormatData
Compare-Object $A $B

InputObject                                                SideIndicator
-----------                                                -------------
Microsoft.BackgroundIntelligentTransfer.Management.BitsJob =>

Get-FormatData *bits* | Export-FormatData -FilePath c:\test\bits.format.ps1xml
Get-Content c:\test\bits.format.ps1xml

<?xml version="1.0" encoding="utf-8"?><Configuration><ViewDefinitions>
<View><Name>Microsoft.BackgroundIntelligentTransfer.Management.BitsJob</Name>
...

Az első négy parancs a Get-FormatData, Import-Moduleés Compare-Object parancsmagok használatával azonosítja a BitsTransfer modul által a munkamenethez hozzáadott formátumtípust.

Az ötödik parancs a Get-FormatData parancsmag használatával lekéri a BitsTransfer modul által hozzáadott formátumtípust. Folyamatoperátort (|) használ a formátumtípus-objektum parancsmagba való Export-FormatData küldéséhez, amely visszaalakítja XML-fájllá, és menti a megadott format.ps1xml fájlba.

Az utolsó parancs a fájl tartalmának egy részletét format.ps1xml jeleníti meg.

5. példa: Formázási adatok lekérése a PowerShell megadott verziója alapján

Ez a példa bemutatja, hogyan lehet formátumadatokat Get-FormatData lekérni egy adott TypeName és PowerShell-verzióhoz.

Get-FormatData -TypeName 'Microsoft.Powershell.Utility.FileHash' -PowerShellVersion $PSVersionTable.PSVersion

TypeNames                               FormatViewDefinition
---------                               --------------------
{Microsoft.Powershell.Utility.FileHash} {Microsoft.Powershell.Utility.FileHash}

Paraméterek

-PowerShellVersion

Adja meg a PowerShell azon verzióját, amelyről a parancsmag lekéri a formázási adatokat. Írjon be egy ponttal elválasztott kétjegyű számot.

Ezt a paramétert a PowerShell 5.1-ben adták hozzá a kompatibilitás javítása érdekében a PowerShell régebbi verzióit futtató számítógépek átnevezésekor.

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

-TypeName

Megadja a parancsmag által a formázási adatokhoz lekért típusneveket. Adja meg a típusneveket. Helyettesítő karakterek használata engedélyezett.

Type:String[]
Position:0
Default value:None
Accept pipeline input:False
Accept wildcard characters:True

Bevitelek

None

Ehhez a parancsmaghoz nem lehet bemenetet átirányítani.

Kimenetek

ExtendedTypeDefinition