Get-FormatData

  • Referenz
Modul:
Microsoft.PowerShell.Utility

Ruft die Formatierungsdaten in der aktuellen Sitzung ab.

Syntax

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

Beschreibung

Das Get-FormatData Cmdlet ruft die Formatierungsdaten in der aktuellen Sitzung ab.

Die Formatierungsdaten in der Sitzung umfassen Formatierungsdaten aus Format.ps1xml Formatierungsdateien, z. B. daten im $PSHOME Verzeichnis, Formatierungsdaten für Module, die Sie in die Sitzung importieren, und Formatierungsdaten für Befehle, die Sie mithilfe des Import-PSSession Cmdlets in Ihre Sitzung importieren.

Mit diesem Cmdlet können Sie die Formatierungsdaten untersuchen. Anschließend können Sie das Export-FormatData Cmdlet verwenden, um die Objekte zu serialisieren, in XML zu konvertieren und in Format.ps1xml Dateien zu speichern.

Weitere Informationen zum Formatieren von Dateien in PowerShell finden Sie unter about_Format.ps1xml.

Beispiele

Beispiel 1: Abrufen aller Formatierungsdaten

In diesem Beispiel werden alle Formatierungsdaten in der Sitzung abgerufen.

Get-FormatData

Beispiel 2: Abrufen von Formatierungsdaten nach Typname

In diesem Beispiel werden die Formatierungsdatenelemente, deren Namen mit System.Management.Automation.Cmdbeginnen.

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

Beispiel 3: Untersuchen eines Formatierungsdatenobjekts

Dieses Beispiel zeigt, wie Sie ein Formatierungsdatenobjekt abrufen und seine Eigenschaften untersuchen.

$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

Beispiel 4: Abrufen von Formatierungsdaten und Exportieren

In diesem Beispiel wird gezeigt, wie Sie die Formatierungsdaten verwenden Get-FormatData und Export-FormatData exportieren, die von einem Modul hinzugefügt werden.

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

Die ersten vier Befehle verwenden die Get-FormatData, Import-Moduleund Compare-Object Cmdlets, um den Formattyp zu identifizieren, den das BitsTransfer-Modul der Sitzung hinzufügt.

Der fünfte Befehl verwendet das Get-FormatData Cmdlet, um den Formattyp abzurufen, den das BitsTransfer-Modul hinzufügt. Es verwendet einen Pipelineoperator (|), um das Formattypobjekt an das Export-FormatData Cmdlet zu senden, das es wieder in XML konvertiert und in der angegebenen format.ps1xml Datei speichert.

Der letzte Befehl zeigt einen Auszug des format.ps1xml Dateiinhalts.

Beispiel 5: Abrufen von Formatierungsdaten basierend auf der angegebenen Version von PowerShell

In diesem Beispiel wird gezeigt, wie Get-FormatData Sie Formatdaten für eine angegebene TypeName - und PowerShell-Version abrufen.

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

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

Wichtig

Um sicherzustellen, dass die vollständigen Typformatierungsinformationen zurückgegeben werden, sollten Sie immer den PowerShellVersion-Parameter mit der entsprechenden Version einschließen. Wenn der Parameter und der Wert nicht angegeben werden, erhalten Sie möglicherweise nicht alle richtigen Typinformationen.

Parameter

-PowerShellVersion

Geben Sie die Version von PowerShell an, die dieses Cmdlet für die Formatierungsdaten abruft. Geben Sie eine zweistellige Zahl ein, die durch einen Punkt getrennt ist.

Dieser Parameter wurde in PowerShell 5.1 hinzugefügt, um die Kompatibilität beim Remoting von Computern mit älteren PowerShell-Versionen zu verbessern.

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

-TypeName

Gibt die Typnamen an, die dieses Cmdlet für die Formatierungsdaten abruft. Geben Sie die Typnamen ein. Platzhalter sind zulässig.

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

Eingaben

None

Sie können keine Objekte an dieses Cmdlet weiterleiten.

Ausgaben

ExtendedTypeDefinition