Ruft die Formatierungsdaten in der aktuellen Sitzung ab. (Get-FormatData)
NAME
Get-FormatData
# ÜBERSICHT
Ruft die Formatierungsdaten in der aktuellen Sitzung ab.
# SYNTAX
Get-FormatData [[-TypeName] <string[]>] [<CommonParameters>]
# BESCHREIBUNG
Das Cmdlet "Get-FormatData" ruft die Formatierungsdaten in der aktuellen Sitzung ab.
Die Formatierungsdaten in der Sitzung umfassen Formatierungsdaten aus FORMAT.PS1XML-Formatierungsdateien (z. B. jenen im Verzeichnis "$pshome"), Formatierungsdaten für Module, die Sie in die Sitzung importieren, und Formatierungsdaten für Befehle, die Sie mit dem Cmdlet "Import-PSSession" in die Sitzung importieren.
Sie können dieses Cmdlet verwenden, um die Formatierungsdaten zu untersuchen. Anschließend können Sie die Objekte mithilfe des Cmdlets "Export-FormatData" serialisieren (in XML konvertieren) und in FORMAT.PS1XML-Dateien speichern.
Weitere Informationen zu Formatierungsdateien in Windows PowerShell finden Sie unter "about_Format.ps1xml".
# PARAMETER
-TypeName <string[]>
Ruft nur die Formatierungsdaten mit den angegebenen Typnamen ab. Geben Sie die Typnamen ein. Platzhalter sind zulässig.
Erforderlich? false
Position? 1
Standardwert
Pipelineeingaben akzeptieren?false
Platzhalterzeichen akzeptieren?true
<CommonParameters>
Dieses Cmdlet unterstützt folgende allgemeine Parameter: "Verbose", "Debug",
"ErrorAction", "ErrorVariable", "WarningAction", "WarningVariable",
"OutBuffer" und "OutVariable". Weitere Informationen
erhalten Sie mit dem Befehl "get-help about_commonparameters".
# EINGABEN
Keiner
Eingaben können nicht über die Pipeline an dieses Cmdlet übergeben werden.
# AUSGABEN
System.Management.Automation.ExtendedTypeDefinition
# HINWEISE
# BEISPIEL 1
C:\PS>get-formatdata
Beschreibung
-----------
Mit diesem Befehl werden alle Formatierungsdaten in der Sitzung abgerufen.
# BEISPIEL 2
C:\PS>get-formatdata -typename Microsoft.Wsman*
Beschreibung
-----------
Mit diesem Befehl werden die Formatierungsdatenelemente abgerufen, deren Name mit "Microsoft.Wsman" beginnt.
# BEISPIEL 3
C:\PS>$f = get-formatdata -typename helpinfoshort
C:\PS> $f
TypeName FormatViewDefinition
-------- --------------------
HelpInfoShort {help , TableControl}
C:\PS> $f.FormatViewDefinition[0].control
Headers Rows
------- ----
{System.Management.Automation.TableControlColumnHeader, System.Manageme... {System.Management.Automation.TableControlRow}
C:\PS> $f.FormatViewDefinition[0].control.headers
Label Alignment Width
----- --------- -----
Name Left 33
Category Left 9
Undefined 0
Beschreibung
-----------
Dieses Beispiel zeigt, wie ein Formatierungsdatenobjekt abgerufen wird und dessen Eigenschaften überprüft werden.
# BEISPIEL 4
C:\PS>$a = get-formatdata
C:\PS> import-module bitstransfer
C:\PS> $b = get-formatdata
C:\PS> compare-object $a $b
InputObject SideIndicator
----------- -------------
Microsoft.BackgroundIntelligentTransfer.Management.BitsJob =>
C:\PS> get-formatdata *bits* | export-formatdata -filepath c:\test\bits.format.ps1xml
C:\PS> get-content c:\test\bits.format.ps1xml
<?xml version="1.0" encoding="utf-8"?><Configuration><ViewDefinitions>
<View><Name>Microsoft.BackgroundIntelligentTransfer.Management.BitsJob</Name>
...
Beschreibung
-----------
In diesem Beispiel wird gezeigt, wie die durch ein Modul hinzugefügten Formatierungsdaten mit Get-FormatData und Export-FormatData exportiert werden.
Die ersten vier Befehle verwenden die Cmdlets "Get-FormatData", "Import-Module" und "Compare-Object", um den Formattyp zu bestimmen, der der Sitzung durch das BitsTransfer-Modul hinzugefügt wird.
Im fünften Befehl wird das Cmdlet "Get-FormatData" verwendet, um den Formattyp abzurufen, der vom BitsTransfer-Modul hinzugefügt wird. Das Formattypobjekt wird mithilfe eines Pipelineoperators (|) an das Cmdlet "Export-FormatData" gesendet, das das Objekt in XML zurückkonvertiert und in der angegebenen FORMAT.PS1XML-Datei speichert.
Der letzte Befehl zeigt einen Auszug aus dem Inhalt der FORMAT.PS1XML-Datei an.
VERWANDTE LINKS
Online version: http://go.microsoft.com/fwlink/?LinkID=144303 (möglicherweise auf Englisch)
Export-FormatData
Update-FormatData
C:\Windows>powershell get-help Export-FormatData -full
ColorConsole [Version 1.7.1000] PowerShell 2.0-Export
Microsoft Windows [Version 6.1.7600]
Copyright (c) 2014 Microsoft Corporation.