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 enthalten Formatierungsdaten aus Format.ps1xml Formatierungsdateien, wie z. B. in dem $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 Cmdlet verwenden, um die Export-FormatData Objekte zu serialisieren, sie 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 -PowerShellVersion 5.1

Wichtig

Um sicherzustellen, dass die vollständigen Typformatierungsinformationen zurückgegeben werden, sollten Sie immer den PowerShellVersion-Parameter mit dem Wert 5.1 einschließen, wenn Sie einen lokalen Aufruf verwenden Get-FormatData. Wenn der Parameter und der Wert nicht angegeben werden, erhalten Sie möglicherweise nicht alle richtigen Typinformationen.

Beispiel 2: Abrufen von Formatierungsdaten nach Typname

In diesem Beispiel werden die Formatierungsdatenelemente angezeigt, deren Namen beginnen System.Management.Automation.Cmd.

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

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*' -PowerShellVersion 5.1
$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 können, die von einem Modul hinzugefügt werden.

$A = Get-FormatData -PowerShellVersion 5.1
Import-Module bitstransfer
$B = Get-FormatData -PowerShellVersion 5.1
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 (|) zum Senden des Formattypobjekts an das Cmdlet, das ihn wieder in XML konvertiert und in der Export-FormatData angegebenen format.ps1xml Datei speichert.

Der endgültige 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}

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 Zeitraum getrennt ist.

Dieser Parameter wurde in PowerShell 5.1 hinzugefügt, um die Kompatibilität zu verbessern, wenn Computer mit älteren Versionen von PowerShell ausgeführt werden.

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

Eingaben können nicht an dieses Cmdlet weitergereicht werden.

Ausgaben

ExtendedTypeDefinition