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
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.Cmd
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: 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-FormatData
azonosí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.
Típus: | Version |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | 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.
Típus: | String[] |
Position: | 0 |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | True |
Bevitelek
None
Ehhez a parancsmaghoz nem lehet objektumokat csövezni.