Freigeben über

Get-FormatData

  • Referenz
Modul:
Microsoft.PowerShell.Utility

Ruft die Formatierungsdaten in der aktuellen Sitzung ab.

Syntax

Get-FormatData
   [[-TypeName] <String[]>]
   [<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, z. B. im Verzeichnis $pshome, Formatierungsdaten für Module, die Sie in die Sitzung importieren, und Formatierungsdaten für Befehle, die Sie mithilfe des Cmdlets Import-PSSession in Ihre Sitzung importieren.

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

Dieser Befehl ruft alle Formatierungsdaten in der Sitzung ab.

Get-FormatData

Beispiel 2: Abrufen von Formatierungsdaten nach Typnamen

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

Mit diesem Befehl werden die Formatierungsdatenelemente abgerufen, deren Namen mit System.Management.Automation.Cmd* beginnen.

Beispiel 3: Untersuchen eines Formatierungsdatenobjekts

$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
-----         ---------      -----
Name          Left           33
Category      Left           9
Undefined      0

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

Beispiel 4: Abrufen und Exportieren von Formatierungsdaten

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

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.

Die ersten vier Befehle verwenden die Cmdlets Get-FormatData, Import-Module und 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. Mit einem Pipelineoperator (|) wird das Formattypobjekt an das Export-FormatData-Cmdlet gesendet, das die Daten in XML zurückkonvertiert und in der angegebenen FORMAT.PS1XML-Datei speichert.

Der letzte Befehl zeigt einen Auszug aus dem Inhalt der FORMAT.PS1XML-Datei.

Parameter

-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