Get-FormatData

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

Syntax

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

Description

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

Data formátování v relaci zahrnují 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, které importujete do relace pomocí rutiny Import-PSSession .

Tuto rutinu můžete použít k prozkoumání dat formátování. 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 dat formátování

Tento příklad získá všechna data formátování 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átující 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 data formátování 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í příkazy Get-FormatData, Import-Modulea Compare-Object rutiny k identifikaci typu formátu, který modul BitsTransfer přidá do relace.

Pátý příkaz použije Get-FormatData rutinu k získání typu formátu, který modul BitsTransfer přidá. Používá operátor kanálu (|) k odeslání objektu 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 format.ps1xml obsahu souboru.

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

V tomto příkladu se dozvíte, 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}

Parametry

-PowerShellVersion

Zadejte verzi PowerShellu, která tato rutina získá pro data formátování. 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.

Type:Version
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-TypeName

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

Type:String[]
Position:0
Default value:None
Accept pipeline input:False
Accept wildcard characters:True

Vstupy

None

Vstup do této rutiny nelze převést.

Výstupy

ExtendedTypeDefinition