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 Get-FormatData cmdlet pobiera dane formatowania w bieżącej sesji.

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

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

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ć funkcji Get-FormatData i Export-FormatData eksportować dane formatowania dodane 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ą Get-FormatDatapoleceń cmdlet , Import-Modulei Compare-Object do identyfikowania typu formatu, który moduł BitsTransfer dodaje do sesji.

Piąte polecenie używa Get-FormatData polecenia cmdlet do pobrania typu formatu, który dodaje moduł BitsTransfer . Używa operatora potoku (|) do wysyłania obiektu typu formatu do Export-FormatData polecenia cmdlet, który konwertuje go z powrotem na XML i zapisuje go w określonym format.ps1xml pliku.

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

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

W tym przykładzie pokazano, jak pobrać Get-FormatData dane formatu dla określonej wersji typeName i programu PowerShell.

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

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

Ważne

Aby upewnić się, że zwracane są pełne informacje o formatowaniu typu, zawsze należy uwzględnić parametr PowerShellVersion z odpowiednią wersją. Jeśli parametr i wartość zostaną pominięte, możesz nie uzyskać wszystkich poprawnych informacji o typie.

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 komputerów z 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

ExtendedTypeDefinition