Get-FormatData
Lekéri a formázási adatokat az aktuális munkamenetben.
Syntax
Default (Alapértelmezett)
Get-FormatData
[[-TypeName] <String[]>]
[<CommonParameters>]
Description
A Get-FormatData parancsmag lekéri az aktuális munkamenet formázási adatait.
A munkamenet formázási adatai közé tartoznak a 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 format.ps1xml fájlokba mentheti őket.
A powershell-fájlok 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 parancs 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
Get-FormatData -TypeName 'System.Management.Automation.Cmd*'
Ez a parancs lekéri azokat a formázási adatelemeket, amelyeknek a neve a System.Management.Automation.Cmd* paranccsal kezdődik.
3. példa: Adatobjektum formázásának vizsgálata
$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
----- --------- -----
Name Left 33
Category Left 9
Undefined 0
Ez a példa bemutatja, hogyan kérhet le egy formázási adatobjektumot, és hogyan vizsgálhatja meg annak tulajdonságait.
4. példa: Formázási adatok lekérdezése és exportálása
$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>
...
Ez a példa bemutatja, hogyan használható Get-FormatData és Export-FormatData a modul által hozzáadott formázási adatok exportálásához.
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ővel (|) küldi el a formátumtípus-objektumot a Export-FormatData parancsmagnak, amely visszakonvertálja XML-fájllá, és menti a megadott format.ps1xml fájlba.
Az utolsó parancs a format.ps1xml fájl tartalmának egy részletét jeleníti meg.
Paraméterek
-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 csövezhet be bemenetet.