Udostępnij za pośrednictwem

Get-FormatData

  • Odwołanie
Moduł:
Microsoft.PowerShell.Utility

Pobiera dane formatowania w bieżącej sesji.

Składnia

Get-FormatData
   [[-TypeName] <String[]>]
   [<CommonParameters>]

Opis

Polecenie cmdlet Get-FormatData pobiera dane formatowania w bieżącej sesji.

Dane formatowania w sesji obejmują formatowanie danych z plików formatowania Format.ps1xml, takich jak te w katalogu $pshome, formatowanie danych modułów importowanych do sesji oraz formatowanie danych dla poleceń importowanych do sesji przy użyciu polecenia Import-PSSession polecenia cmdlet.

To polecenie cmdlet służy do badania danych formatowania. Następnie możesz użyć polecenia cmdlet Export-FormatData, aby serializować obiekty, konwertować je na XML i zapisywać w plikach Format.ps1xml.

Aby uzyskać więcej informacji na temat formatowania plików w programie PowerShell, zobacz about_Format.ps1xml.

Przykłady

Przykład 1. Pobieranie wszystkich danych formatowania

To polecenie pobiera wszystkie dane formatowania w sesji.

Get-FormatData

Przykład 2. Pobieranie danych formatowania według nazwy typu

Get-FormatData -TypeName 'System.Management.Automation.Cmd*'

To polecenie pobiera elementy danych formatowania, których nazwy zaczynają się od System.Management.Automation.Cmd*.

Przykład 3. Badanie obiektu danych formatowania

$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
-----         ---------      -----
Name          Left           33
Category      Left           9
Undefined      0

W tym przykładzie pokazano, jak uzyskać obiekt danych formatowania i zbadać jego właściwości.

Przykład 4. Pobieranie danych formatowania i eksportowanie ich

$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>
...

W tym przykładzie pokazano, jak za pomocą Get-FormatData i Export-FormatData wyeksportować dane formatowania dodane przez moduł.

Pierwsze cztery polecenia używają Get-FormatData, Import-Module i Compare-Object poleceń cmdlet w celu zidentyfikowania typu formatu, który moduł BitsTransfer dodaje do sesji.

Piąte polecenie używa polecenia cmdlet Get-FormatData, aby uzyskać typ formatu dodany przez moduł BitsTransfer. Używa operatora potoku (|) do wysyłania obiektu typu formatu do polecenia cmdlet Export-FormatData, które konwertuje go z powrotem na xml i zapisuje go w określonym pliku format.ps1xml.

Ostatnie polecenie przedstawia fragment zawartości pliku format.ps1xml.

Parametry

-TypeName

Określa nazwy typów pobierane przez to polecenie cmdlet dla danych formatowania. Wprowadź nazwy typów. Dozwolone są symbole wieloznaczne.

Typ:String[]
Position:0
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:True

Dane wejściowe

None

Nie można przekazać danych wejściowych potoku do tego polecenia cmdlet.

Dane wyjściowe

ExtendedTypeDefinition