Update-FormatData

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

Aktualizacje 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 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ż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 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.

Type:String[]
Aliases:PSPath, Path
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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.