Get-FormatData
Ruft die Formatierungsdaten in der aktuellen Sitzung ab.
Syntax
Default (Standardwert)
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, wie sie sich im Verzeichnis $PSHOME befinden, 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 zu Formatierungsdateien in Windows PowerShell finden Sie unter about_Format.ps1xml.
Beispiele
Beispiel 1: Abrufen aller Formatierungsdaten
In diesem Beispiel werden alle Formatierungsdaten im Sitzungskontext abgerufen.
Get-FormatData
Beispiel 2: Abrufen von Formatierungsdaten nach Typname
In diesem Beispiel werden die Formatierungsdatenelemente ermittelt, deren Namen mit System.Management.Automation.Cmd beginnen.
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.
Im fünften Befehl wird mit dem Get-FormatData-Cmdlet der Formattyp abgerufen, 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 Bits.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 PowerShell-Version an, die dieses Cmdlet zur Abfrage der Formatierungsdaten verwendet. Geben Sie eine zweistellige Zahl mit einem Punkt zwischen den Ziffern ein.
Dieser Parameter wurde in PowerShell 5.1 hinzugefügt, um die Kompatibilität beim Remoting auf Computern mit älteren PowerShell-Versionen zu verbessern.
Parametereigenschaften
| Typ: | Version |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-TypeName
Gibt die Typnamen an, die dieses Cmdlet für die Formatierungsdaten abruft. Geben Sie die Typnamen ein. Wildcards sind zulässig.
Parametereigenschaften
| Typ: | String[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | True |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 0 |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
CommonParameters
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
None
Sie können keine Objekte an dieses Cmdlet weiterleiten.
