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[]>]
   [-PowerShellVersion <Version>]
   [<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 dla modułów importowanych do sesji oraz formatowanie danych dla poleceń importowanych do sesji przy użyciu polecenia cmdlet Import-PSSession.

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

Ten przykład pobiera wszystkie dane formatowania w sesji.

Get-FormatData

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

Ten przykład pobiera elementy danych formatowania, których nazwy zaczynają się od System.Management.Automation.Cmd.

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

Przykład 3. Badanie obiektu danych formatowania

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

$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

Przykład 4. Pobieranie danych formatowania i eksportowanie ich

W tym przykładzie pokazano, jak używać Get-FormatData i Export-FormatData do eksportowania danych formatowania dodanych przez moduł.

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

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

Piąte polecenie używa polecenia cmdlet Get-FormatData w celu pobrania typu formatu, który dodaje 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 Bits.format.ps1xml.

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

Przykład 5. Pobieranie danych formatowania na podstawie określonej wersji programu PowerShell

W tym przykładzie pokazano, jak używać Get-FormatData do pobierania danych formatu dla określonej TypeName i wersji programu PowerShell.

Get-FormatData -TypeName 'Microsoft.Powershell.Utility.FileHash' -PowerShellVersion $PSVersionTable.PSVersion

TypeNames                               FormatViewDefinition
---------                               --------------------
{Microsoft.Powershell.Utility.FileHash} {Microsoft.Powershell.Utility.FileHash}

Parametry

-PowerShellVersion

Określ wersję programu PowerShell pobieraną przez to polecenie cmdlet dla danych formatowania. Wprowadź dwie cyfry rozdzielone kropką.

Ten parametr został dodany w programie PowerShell 5.1, aby zwiększyć zgodność podczas komunikacji zdalnej na komputerach ze starszymi wersjami programu PowerShell.

Typ:Version
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-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 potokować obiektów do tego polecenia cmdlet.

Dane wyjściowe