Číst v angličtině

Sdílet prostřednictvím

Get-FormatData

  • Reference
Modul:
Microsoft.PowerShell.Utility

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

Syntaxe

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

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

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

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

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

PowerShell 
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 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 k počítačům 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