Get-FormatData
Ruft die Formatierungsdaten in der aktuellen Sitzung ab.
Get-FormatData
[[-TypeName] <String[]>]
[-PowerShellVersion <Version>]
[<CommonParameters>]
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.
In diesem Beispiel werden alle Formatierungsdaten in der Sitzung abgerufen.
Get-FormatData
In diesem Beispiel werden die Formatierungsdatenelemente, deren Namen mit System.Management.Automation.Cmd
beginnen, zurückgegeben.
Get-FormatData -TypeName 'System.Management.Automation.Cmd*'
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
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-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. Es verwendet einen Pipelineoperator (|
), um das Formattypobjekt an das Cmdlet Export-FormatData
zu senden, das es in XML konvertiert und in der angegebenen bits.format.ps1xml
Datei speichert.
Der letzte Befehl zeigt einen Auszug des format.ps1xml
Dateiinhalts.
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}
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 auf Computern mit älteren PowerShell-Versionen zu verbessern.
Typ: | Version |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
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 |
None
Sie können keine Objekte an dieses Cmdlet weiterleiten.
Feedback zu PowerShell
PowerShell ist ein Open Source-Projekt. Wählen Sie einen Link aus, um Feedback zu geben: