Get-FormatData

  • Referencia
Modul:
Microsoft.PowerShell.Utility

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 címtárban lévők, a munkamenetbe importált modulok adatainak formázása, valamint a parancsmag használatával Import-PSSession 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 további információt a about_Format.ps1xml című témakörben talál.

Példák

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

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

Get-FormatData

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

Ez a példa beolvasja 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: Adatok formázása é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 , Import-Moduleés parancsmagokkal Get-FormatDataazonosítja a BitsTransfer modul által a munkamenethez hozzáadott formátumtípustCompare-Object.

Az ötödik parancs a Get-FormatData parancsmaggal lekéri a BitsTransfer modul által hozzáadott formátumtípust. Egy folyamatkezelővel (|) küldi el a formátum típusú objektumot a Export-FormatData parancsmagnak, 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 jeleníti meg format.ps1xml .

5. példa: Adatok formázása a PowerShell megadott verziója alapján

Ez a példa bemutatja, hogyan kérhet Get-FormatData le formátumadatokat 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, amely a parancsmagban lekéri a formázási adatokat. Adjon meg egy ponttal elválasztott kétjegyű számot.

Ez a paraméter a PowerShell 5.1-ben lett hozzáadva a kompatibilitás javítása érdekében a PowerShell régebbi verzióit futtató számítógépek újbóli létrehozásakor.

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

-TypeName

Megadja, hogy a parancsmag milyen típusneveket kap a formázási adatokhoz. Adja meg a típusneveket. Helyettesítő karakterek használata engedélyezett.

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

Bevitelek

None

Ehhez a parancsmaghoz nem lehet objektumokat csövezni.

Kimenetek

ExtendedTypeDefinition