Get-FormatData
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.Cmd
beginnen.
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-FormatData
Cmdlets , Import-Module
und 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
Sie können keine Objekte an dieses Cmdlet übergeben.