Dela via

Get-FormatData

  • Referens
Modul:
Microsoft.PowerShell.Utility

Hämtar formateringsdata i den aktuella sessionen.

Syntax

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

Description

Cmdleten Get-FormatData hämtar formateringsdata i den aktuella sessionen.

Formateringsdata i sessionen innehåller formateringsdata från Format.ps1xml-formateringsfiler, till exempel de i $pshome-katalogen, formateringsdata för moduler som du importerar till sessionen och formatering av data för kommandon som du importerar till sessionen med hjälp av cmdleten Import-PSSession.

Du kan använda den här cmdleten för att undersöka formateringsdata. Sedan kan du använda cmdleten Export-FormatData för att serialisera objekten, konvertera dem till XML och spara dem i Format.ps1xml-filer.

Mer information om hur du formaterar filer i PowerShell finns i about_Format.ps1xml.

Exempel

Exempel 1: Hämta alla formateringsdata

Det här kommandot hämtar alla formateringsdata i sessionen.

Get-FormatData

Exempel 2: Hämta formateringsdata efter typnamn

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

Det här kommandot hämtar formateringsdataobjekt vars namn börjar med System.Management.Automation.Cmd*.

Exempel 3: Granska ett formateringsdataobjekt

$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

Det här exemplet visar hur du hämtar ett formateringsdataobjekt och undersöker dess egenskaper.

Exempel 4: Hämta formateringsdata och exportera dem

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

Det här exemplet visar hur du använder Get-FormatData och Export-FormatData för att exportera formateringsdata som läggs till av en modul.

De första fyra kommandona använder cmdletarna Get-FormatData, Import-Module och Compare-Object för att identifiera formattypen som BitsTransfer-modulen lägger till i sessionen.

Det femte kommandot använder cmdleten Get-FormatData för att hämta formattypen som BitsTransfer-modulen lägger till. Den använder en pipelineoperator (|) för att skicka formattypsobjektet till cmdleten Export-FormatData, som konverterar tillbaka det till XML och sparar det i den angivna format.ps1xml-filen.

Det sista kommandot visar ett utdrag av format.ps1xml-filinnehållet.

Parametrar

-TypeName

Anger de typnamn som den här cmdleten hämtar för formateringsdata. Ange typnamnen. Jokertecken tillåts.

Typ:String[]
Position:0
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:True

Indata

None

Du kan inte skicka indata till den här cmdleten.

Utdata

ExtendedTypeDefinition