Sdílet prostřednictvím

Get-FormatData

  • Reference
Modul:
Microsoft.PowerShell.Utility

Získá formátovací data v aktuální relaci.

Syntaxe

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

Description

Rutina Get-FormatData získá formátovací data v aktuální relaci.

Formátování dat v relaci zahrnuje formátování dat z Format.ps1xml formátovacích souborů, jako jsou například data v $PSHOME adresáři, 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. Pak 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 použít 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í Get-FormatDatak Import-Moduleidentifikaci typu formátu, který modul BitsTransfer přidá do relace, a Compare-Object rutiny.

Pátý příkaz pomocí rutiny Get-FormatData získá typ formátu, který modul BitsTransfer přidá. Pomocí operátoru kanálu (|) odešle objekt typu formátu do Export-FormatData rutiny, který ho převede zpět na XML a uloží ho do zadaného format.ps1xml souboru.

Poslední příkaz zobrazí výňatek obsahu format.ps1xml souboru.

Příklad 5: Získání formátovaných dat na základě zadané verze PowerShellu

Tento příklad ukazuje, jak získat Get-FormatData formátovaná data pro zadanou verzi TypeName a 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.

Typ:Version
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-TypeName

Určuje názvy typů, které tato rutina získá pro formátovací data. Zadejte názvy typů. Jsou povoleny zástupné cardy.

Typ:String[]
Position:0
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:True

Vstupy

None

Do této rutiny nemůžete roušit objekty.

Výstupy

ExtendedTypeDefinition