Get-FormatData

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

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

Zu den Formatierungsdaten in der Sitzung gehören das Formatieren von Daten aus Format.ps1xml-Formatierungsdateien, z. B. im Verzeichnis $pshome, das Formatieren von Daten für Module, die Sie in die Sitzung importieren, und das Formatieren von Daten für Befehle, die Sie mithilfe des Cmdlets Import-PSSession in die 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 den Dateien Format.ps1xml zu speichern.

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

Mit diesem Befehl werden alle Formatierungsdaten in der Sitzung abgerufen.

Get-FormatData

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

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

$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

In diesem Beispiel wird gezeigt, wie Sie ein Formatierungsdatenobjekt abrufen und dessen Eigenschaften untersuchen.

$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 Get-FormatData und Export-FormatData verwendet werden, um die Formatierungsdaten zu exportieren, die von einem Modul hinzugefügt werden.

In den ersten vier Befehlen werden die Cmdlets Get-FormatData, Import-Module und Compare-Object verwendet, um den Formattyp zu identifizieren, den das BitsTransfer-Modul der Sitzung hinzufügt.

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

Der letzte Befehl zeigt einen Auszug aus dem Inhalt der Datei format.ps1xml.

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Eingaben können nicht an dieses Cmdlet weitergereicht werden.