Get-FormatData
Pobiera dane formatowania w bieżącej sesji.
Składnia
Default (Domyślna)
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.
Możesz użyć tego polecenia cmdlet do przeglądania 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 formatowania danych, 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 do pobrania typu formatu dodawanego 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 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.
Właściwości parametru
| Typ: | Version |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-TypeName
Określa nazwy typów, które to polecenie cmdlet uzyskuje dla danych formatowania. Wprowadź nazwy typów. Symbole wieloznaczne są dozwolone.
Właściwości parametru
| Typ: | String[] |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | True |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | 0 |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
CommonParameters
To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.
Dane wejściowe
None
Nie można przekazywać obiektów do tego cmdletu.
