Udostępnij za pomocą

Update-FormatData

Moduł:
Microsoft.PowerShell.Utility Module

Aktualizuje dane formatowania w bieżącej sesji.

Składnia

Default (Domyślna) 

Update-FormatData
    [[-AppendPath] <String[]>]
    [-PrependPath <String[]>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Opis

Polecenie cmdlet Update-FormatData ponownie ładuje dane formatowania z plików formatowania do bieżącej sesji. To polecenie cmdlet umożliwia aktualizowanie danych formatowania bez ponownego uruchamiania programu PowerShell.

Bez parametrów Update-FormatData ponownie ładuje załadowane wcześniej pliki formatowania. Możesz użyć parametrów Update-FormatData, aby dodać nowe pliki formatowania do sesji.

Pliki formatowania to pliki tekstowe w formacie XML z rozszerzeniem nazwy pliku format.ps1xml. Dane formatowania w plikach definiują wyświetlanie obiektów programu Microsoft .NET Framework w sesji.

Po uruchomieniu programu PowerShell ładuje dane formatu z kodu źródłowego programu PowerShell. Można jednak utworzyć pliki custom format.ps1xml w celu zaktualizowania formatowania w bieżącej sesji. Można użyć Update-FormatData, aby ponownie załadować dane formatowania do bieżącej sesji bez ponownego uruchomienia programu PowerShell. Jest to przydatne w przypadku dodania lub zmiany pliku formatowania, ale nie chcesz przerywać sesji.

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

Przykłady

Przykład 1. Ponowne ładowanie wcześniej załadowanych plików formatowania

Update-FormatData

To polecenie ponownie ładuje pliki formatowania, które zostały załadowane wcześniej.

Przykład 2. Ponowne ładowanie plików formatowania i plików śledzenia i formatowania dziennika

Update-FormatData -AppendPath Trace.format.ps1xml, Log.format.ps1xml

To polecenie ponownie ładuje pliki formatowania do sesji, w tym dwa nowe pliki, Trace.format.ps1xml i Log.format.ps1xml.

Ponieważ polecenie używa parametru AppendPath, dane formatowania w nowych plikach są ładowane po sformatowaniu danych z wbudowanych plików.

Używany jest parametr AppendPath, ponieważ nowe pliki zawierają dane formatowania dla obiektów, do których nie odwołuje się wbudowane pliki.

Przykład 3. Edytowanie pliku formatowania i ponowne załadowanie go

Update-FormatData -PrependPath "C:\test\NewFiles.format.ps1xml"

# Edit the NewFiles.format.ps1 file.

Update-FormatData

W tym przykładzie pokazano, jak ponownie załadować plik formatowania po jego zmodyfikowaniu.

Pierwsze polecenie dodaje plik NewFiles.format.ps1xml do sesji. Używa on parametru PrependPath, ponieważ plik zawiera dane formatowania obiektów, do których odwołuje się wbudowane pliki.

Po dodaniu pliku NewFiles.format.ps1xml i przetestowaniu go w tych sesjach autor edytuje plik.

Drugie polecenie używa polecenia cmdlet Update-FormatData do ponownego załadowania plików formatowania. Ponieważ plik NewFiles.format.ps1xml został wcześniej załadowany, Update-FormatData automatycznie go ponownie załaduje bez użycia parametrów.

Parametry

-AppendPath

Określa pliki formatowania, które to polecenie cmdlet dodaje do sesji. Pliki są ładowane po załadowaniu wbudowanych plików formatowania programu PowerShell.

Podczas formatowania obiektów platformy .NET program PowerShell używa pierwszej definicji formatowania znalezionej dla każdego typu platformy .NET. Jeśli używasz parametru AppendPath, program PowerShell przeszukuje dane z wbudowanych plików, zanim napotka dodawane dane formatowania.

Użyj tego parametru, aby dodać plik, który formatuje obiekt .NET, do którego nie odwołuje się wbudowany plik formatowania.

Właściwości parametru

Typ:

String[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:PSPath, Ścieżka

Zestawy parametrów

(All)
Position:0
Obowiązkowy:False
Wartość z potoku:True
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

-Confirm

Prosi o potwierdzenie przed uruchomieniem cmdletu.

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:False
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:por

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

-PrependPath

Określa pliki formatowania, które to polecenie cmdlet dodaje do sesji. Pliki są ładowane przed załadowaniem wbudowanych plików formatowania programu PowerShell.

Podczas formatowania obiektów platformy .NET program PowerShell używa pierwszej definicji formatowania znalezionej dla każdego typu platformy .NET. Jeśli używasz parametru PrependPath, program PowerShell przeszukuje dane z dodanych plików, zanim napotka dane formatowania z wbudowanych plików.

Użyj tego parametru, aby dodać plik, który formatuje obiekt .NET, do którego odwołuje się również wbudowane pliki formatowania.

Właściwości parametru

Typ:

String[]

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

-WhatIf

Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Cmdlet nie jest uruchomiony.

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:False
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:Wi

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

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

String

Możesz potokować ciąg zawierający ścieżkę dołączania do tego polecenia cmdlet.

Dane wyjściowe

None

To polecenie cmdlet nie zwraca żadnych danych wyjściowych.

Uwagi

  • Update-FormatData także aktualizuje dane formatowania poleceń w sesji zaimportowanej z modułów. Jeśli plik formatowania modułu ulegnie zmianie, możesz uruchomić polecenie Update-FormatData, aby zaktualizować dane formatowania dla zaimportowanych poleceń. Nie trzeba ponownie importować modułu.