Get-FormatData

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

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 katalogen $PSHOME, 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.

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

Get-FormatData

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

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

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

$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

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.

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

De första fyra kommandona använder cmdletarna Get-FormatData, Import-Moduleoch Compare-Object för att identifiera formattypen som modulen BitsTransfer 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 Export-FormatData-cmdleten, som konverterar tillbaka det till XML och sparar det i den angivna Bits.format.ps1xml filen.

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

Det här exemplet visar hur du använder Get-FormatData för att hämta formatdata för en angiven TypeName- och PowerShell-version.

Get-FormatData -TypeName 'Microsoft.Powershell.Utility.FileHash' -PowerShellVersion $PSVersionTable.PSVersion

TypeNames                               FormatViewDefinition
---------                               --------------------
{Microsoft.Powershell.Utility.FileHash} {Microsoft.Powershell.Utility.FileHash}

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

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