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 Update-FormatData cmdlet 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 załaduje ponownie pliki formatowania załadowane wcześniej. Możesz użyć parametrów , Update-FormatData aby dodać nowe pliki formatowania do sesji.

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

Po uruchomieniu programu Windows PowerShell dane formatu są ładowane z plików formatowania w katalogu instalacyjnym programu PowerShell ($pshome) do sesji. Możesz użyć Update-FormatData polecenia , 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 , formatowanie danych w nowych plikach jest ładowane po sformatowaniu danych z wbudowanych plików.

Parametr AppendPath jest używany, 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 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 Update-FormatData polecenia cmdlet do ponownego załadowania plików formatowania. Ponieważ plik NewFiles.format.ps1xml został wcześniej załadowany, Update-FormatData automatycznie ponownie go 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 .NET program Windows PowerShell używa pierwszej definicji formatowania znalezionej dla każdego typu platformy .NET. Jeśli używasz parametru AppendPath , program Windows 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 Windows PowerShell używa pierwszej definicji formatowania znalezionej dla każdego typu platformy .NET. Jeśli używasz parametru PrependPath , program Windows 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 po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.

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 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 Aktualizuje również dane formatowania dla poleceń w sesji, które zostały zaimportowane z modułów. Jeśli plik formatowania modułu ulegnie zmianie, możesz uruchomić Update-FormatData polecenie , aby zaktualizować dane formatowania dla zaimportowanych poleceń. Nie trzeba ponownie importować modułu.