Udostępnij za pośrednictwem

Update-FormatData

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

Aktualizuje dane formatowania w bieżącej sesji.

Składnia

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 do sesji plik NewFiles.format.ps1xml. 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 je ponownie ł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.

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

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych: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.

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

-WhatIf

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

Typ:SwitchParameter
Aliasy:wi
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

String

Możesz przekazać ciąg zawierający ścieżkę dołączania do Update-FormatData.

Dane wyjściowe

None

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.