Get-FormatData

Modul:
Microsoft.PowerShell.Utility Module

Ruft die Formatierungsdaten in der aktuellen Sitzung ab.

Syntax

Default (Standard) 

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. daten im $PSHOME 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 zu Formatierungsdateien in Windows 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 Typname

In diesem Beispiel werden die Formatierungsdatenelemente, deren Namen mit System.Management.Automation.Cmdbeginnen.

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 die Formatierungsdaten verwenden Get-FormatData und Export-FormatData 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 Get-FormatData, Import-Moduleund Compare-Object Cmdlets, 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 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 Sie Formatdaten für eine angegebene TypeName - und PowerShell-Version abrufen.

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 zweistellige Zahl ein, die durch einen Punkt getrennt ist.

Dieser Parameter wurde in PowerShell 5.1 hinzugefügt, um die Kompatibilität beim Remoting von 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.

Ausgaben

ExtendedTypeDefinition