Share via

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. aus denen $PSHOME im 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 Typnamen

In diesem Beispiel werden die Formatierungsdatenelemente abgerufen, 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 und Exportieren von Formatierungsdaten

In diesem Beispiel wird gezeigt, wie Get-FormatData und Export-FormatData zum Exportieren der Formatierungsdaten verwendet wird, 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-FormatDataCmdlets , Import-Moduleund Compare-Object , 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 an.

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

In diesem Beispiel wird gezeigt, wie sie verwenden Get-FormatData , um Formatdaten für eine angegebene TypeName - und PowerShell-Version abzurufen.

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 durch einen Punkt getrennte zweistellige Zahl ein.

Dieser Parameter wurde in PowerShell 5.1 hinzugefügt, um die Kompatibilität beim Remoting von Computern zu verbessern, auf denen ältere 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