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

Get-FormatData

Modul:
Microsoft.PowerShell.Utility Module

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

Syntax

Default (Alapértelmezett) 

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

Description

A Get-FormatData parancsprogram adja vissza a formázási adatokat az aktuális munkamenetben.

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

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 mentheti őket Format.ps1xml fájlokba.

A fájlok PowerShellben való formázásáról további információt a about_Format.ps1xmlcí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 beolvas minden olyan formázási adatelemet, amelynek neve a(z) System.Management.Automation.Cmdkarakterekkel kezdő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érdezése és exportálása

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

$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 parancsmagokkal azonosítja a BitsTransfer modul által a munkamenethez hozzáadott formátumtípust.

Az ötödik parancs a Get-FormatData parancsmagot használja a BitsTransfer modul által hozzáadott formátumtípus lekéréséhez. Egy folyamatkezelőt (|) használ a formátumtípus objektumának a Export-FormatData parancsmagba való küldéséhez, amely visszaalakítja XML-fájllá, és menti a megadott Bits.format.ps1xml fájlba.

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

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

Ez a példa bemutatja, hogyan lekérhet Get-FormatData formátumadatokat egy megadott TypeName-hez é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 annak a PowerShell verziónak a számát, amelyhez ez a parancsmag 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épekre való újrakapcsoláskor.

Paramétertulajdonságok

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

-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.

Paramétertulajdonságok

Típus:

String[]

Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:True
DontShow:False

Paraméterkészletek

(All)
Position:0
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

None

Ehhez a parancsmaghoz nem lehet objektumokat csövezni.

Kimenetek

ExtendedTypeDefinition