Freigeben über

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 Cmdlet Get-FormatData ruft die Formatierungsdaten in der aktuellen Sitzung ab.

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

Mit diesem Cmdlet können Sie die Formatierungsdaten untersuchen. Anschließend können Sie das Cmdlet Export-FormatData 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, zurückgegeben.

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

Beispiel 3: Untersuchen eines Formatierungsdatenobjekts

In diesem Beispiel wird gezeigt, wie Sie ein Formatierungsdatenobjekt abrufen und dessen 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 Get-FormatData und Export-FormatData verwenden, um die Formatierungsdaten zu 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 Cmdlets Get-FormatData, Import-Moduleund Compare-Object, um den Formattyp zu identifizieren, den das BitsTransfer Modul der Sitzung hinzufügt.

Der fünfte Befehl verwendet das cmdlet Get-FormatData, um den Formattyp abzurufen, den das BitsTransfer Modul hinzufügt. Es verwendet einen Pipelineoperator (|), um das Formattypobjekt an das Cmdlet Export-FormatData zu senden, das es 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 zum Abrufen von Formatdaten für eine angegebene TypeName-- und PowerShell-Version verwendet wird.

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

Typ:Version
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-TypeName

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

Typ:String[]
Position:0
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:True

Eingaben

None

Sie können keine Eingabe an dieses Cmdlet weiterleiten.

Ausgaben

ExtendedTypeDefinition