Get-FormatData

Modul:: Microsoft.PowerShell.Utility Module

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

Syntax

Default (Výchozí)

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

Description

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

Formátovací data v relaci zahrnují formátování dat ze souborů formátování Format.ps1xml, například z $pshome adresáře, 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 souborů Format.ps1xml.

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říkaz získá všechna formátovací data v relaci.

Get-FormatData

Příklad 2: Získání formátování dat podle názvu typu

Get-FormatData -TypeName 'System.Management.Automation.Cmd*'

Tento příkaz získá formátování datových položek, jejichž názvy začínají na System.Management.Automation.Cmd*.

Příklad 3: Prozkoumání datového objektu formátování

$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

Tento příklad ukazuje, jak získat formátovaný datový objekt a prozkoumat jeho vlastnosti.

Příklad 4: Získání formátování dat a jejich export

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

Tento příklad ukazuje, jak pomocí Get-FormatData a Export-FormatData exportovat formátovací data přidaná modulem.

První čtyři příkazy používají rutiny Get-FormatData, Import-Module a 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ává. 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 format.ps1xml.

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

Parametry

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

Sdílet prostřednictvím