Get-FormatData
Získá formátovací data v aktuální relaci.
Syntax
Default (Výchozí)
Get-FormatData
[[-TypeName] <String[]>]
[-PowerShellVersion <Version>]
[<CommonParameters>]
Description
Rutina Get-FormatData získá formátovací data v aktuální relaci.
Data formátování v relaci zahrnují formátování dat z Format.ps1xml formátovacích souborů, jako jsou soubory v adresáři $PSHOME, formátování dat pro moduly, které importujete do relace, a formátování dat pro příkazy importované do relace pomocí rutiny Import-PSSession.
Tuto rutinu můžete použít k prozkoumání formátových dat. Potom můžete pomocí Export-FormatData rutiny serializovat objekty, převést je na XML a uložit je do Format.ps1xml souborů.
Další informace o formátování souborů v PowerShellu najdete v tématu about_Format.ps1xml.
Příklady
Příklad 1: Získání všech formátových dat
Tento příklad získá všechna formátovaná data v relaci.
Get-FormatData
Příklad 2: Získání formátování dat podle názvu typu
Tento příklad získá formátování datových položek, jejichž názvy začínají System.Management.Automation.Cmd.
Get-FormatData -TypeName 'System.Management.Automation.Cmd*'
Příklad 3: Prozkoumání datového objektu formátování
Tento příklad ukazuje, jak získat formátovaný datový objekt a prozkoumat jeho vlastnosti.
$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
Příklad 4: Získání formátování dat a jejich export
Tento příklad ukazuje, jak pomocí Get-FormatData a Export-FormatData exportovat formátovaná data přidaná modulem.
$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>
...
První čtyři příkazy používají rutiny Get-FormatData, Import-Modulea Compare-Object k identifikaci typu formátu, který modul BitsTransfer přidá do relace.
Pátý příkaz používá rutinu Get-FormatData k získání typu formátu, který modul BitsTransfer přidá. Pomocí operátoru kanálu (|) odešle objekt typu formátu do rutiny Export-FormatData, která ho převede zpět na XML a uloží ho do zadaného souboru Bits.format.ps1xml.
Poslední příkaz zobrazí výňatek obsahu souboru format.ps1xml.
Příklad 5: Získání formátovaných dat na základě zadané verze PowerShellu
Tento příklad ukazuje, jak pomocí Get-FormatData získat formátovaná data pro zadanou TypeName a verzi PowerShellu.
Get-FormatData -TypeName 'Microsoft.Powershell.Utility.FileHash' -PowerShellVersion $PSVersionTable.PSVersion
TypeNames FormatViewDefinition
--------- --------------------
{Microsoft.Powershell.Utility.FileHash} {Microsoft.Powershell.Utility.FileHash}
Důležité
Pokud chcete zajistit, aby se vrátily informace o úplném formátování typu, měli byste vždy zahrnout parametr PowerShellVersion s příslušnou verzí. Pokud parametr a hodnota vynecháte, nemusí se zobrazit všechny správné informace o typu.
Parametry
-PowerShellVersion
Zadejte verzi PowerShellu, která tato rutina získá pro formátovací data. Zadejte dvě číslice oddělené tečkou.
Tento parametr byl přidán v PowerShellu 5.1, aby se zlepšila kompatibilita při vzdálené komunikace počítačů se staršími verzemi PowerShellu.
Vlastnosti parametru
| Typ: | Version |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-TypeName
Určuje názvy typů, které tato rutina získá pro formátovací data. Zadejte názvy typů. Jsou povoleny zástupné symboly.
Vlastnosti parametru
| Typ: | String[] |
| Default value: | None |
| Podporuje zástupné znaky: | True |
| DontShow: | False |
Sady parametrů
(All)
| Position: | 0 |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
CommonParameters
Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.
Vstupy
None
Do tohoto cmdletu nemůžete předávat objekty.
