Update-FormatData

  • Referens
Modul:
Microsoft.PowerShell.Utility

Uppdaterar formateringsdata i den aktuella sessionen.

Syntax

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

Description

Cmdleten Update-FormatData läser in formateringsdata igen från formateringsfiler till den aktuella sessionen. Med den här cmdleten kan du uppdatera formateringsdata utan att starta om PowerShell.

Utan parametrar Update-FormatData läser du in formateringsfilerna som lästes in tidigare. Du kan använda parametrarna Update-FormatData för för att lägga till nya formateringsfiler i sessionen.

Formateringsfiler är textfiler i XML-format med filnamnstillägget format.ps1xml . Formateringsdata i filerna definierar visningen av Microsoft .NET Framework-objekt i sessionen.

När PowerShell startar läses formatdata in från PowerShell-källkoden. Du kan dock skapa anpassade format.ps1xml-filer för att uppdatera formateringen i den aktuella sessionen. Du kan använda Update-FormatData för att läsa in formateringsdata i den aktuella sessionen igen utan att starta om PowerShell. Detta är användbart när du har lagt till eller ändrat en formateringsfil, men inte vill avbryta sessionen.

Mer information om hur du formaterar filer i PowerShell finns i about_Format.ps1xml.

Exempel

Exempel 1: Läs in tidigare inlästa formateringsfiler igen

Update-FormatData

Det här kommandot läser in formateringsfilerna som lästes in tidigare.

Exempel 2: Läs in formateringsfiler och spårnings- och loggformateringsfiler igen

Update-FormatData -AppendPath "trace.format.ps1xml, log.format.ps1xml"

Det här kommandot läser in formateringsfilerna i sessionen igen, inklusive två nya filer, Trace.format.ps1xml och Log.format.ps1xml.

Eftersom kommandot använder parametern AppendPath läses formateringsdata i de nya filerna in efter formateringsdata från de inbyggda filerna.

Parametern AppendPath används eftersom de nya filerna innehåller formateringsdata för objekt som inte refereras till i de inbyggda filerna.

Exempel 3: Redigera en formateringsfil och läs in den igen

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

# Edit the NewFiles.format.ps1 file.

Update-FormatData

Det här exemplet visar hur du läser in en formateringsfil igen när du har redigerat den.

Det första kommandot lägger till filen NewFiles.format.ps1xml i sessionen. Den använder parametern PrependPath eftersom filen innehåller formateringsdata för objekt som refereras till i de inbyggda filerna.

När du har lagt till filen NewFiles.format.ps1xml och testat den i dessa sessioner redigerar författaren filen.

Det andra kommandot använder cmdleten Update-FormatData för att läsa in formateringsfilerna igen. Eftersom filen NewFiles.format.ps1xml tidigare lästes in läser Update-FormatData du automatiskt in den igen utan att använda parametrar.

Parametrar

-AppendPath

Anger formatering av filer som den här cmdleten lägger till i sessionen. Filerna läses in när PowerShell har läst in de inbyggda formateringsfilerna.

När du formaterar .NET-objekt använder PowerShell den första formateringsdefinitionen som hittas för varje .NET-typ. Om du använder parametern AppendPath söker PowerShell igenom data från de inbyggda filerna innan den stöter på formateringsdata som du lägger till.

Använd den här parametern om du vill lägga till en fil som formaterar ett .NET-objekt som inte refereras till i de inbyggda formateringsfilerna.

Typ:String[]
Alias:PSPath, Path
Position:0
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Typ:SwitchParameter
Alias:cf
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-PrependPath

Anger formatering av filer som den här cmdleten lägger till i sessionen. Filerna läses in innan PowerShell läser in de inbyggda formateringsfilerna.

När du formaterar .NET-objekt använder PowerShell den första formateringsdefinitionen som hittas för varje .NET-typ. Om du använder parametern PrependPath söker PowerShell igenom data från de filer som du lägger till innan formateringsdata påträffas från de inbyggda filerna.

Använd den här parametern om du vill lägga till en fil som formaterar ett .NET-objekt som också refereras till i de inbyggda formateringsfilerna.

Typ:String[]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

Typ:SwitchParameter
Alias:wi
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

String

Du kan skicka en sträng som innehåller sökvägen till den här cmdleten.

Utdata

None

Den här cmdleten returnerar inga utdata.

Kommentarer

  • Update-FormatData uppdaterar också formateringsdata för kommandon i sessionen som importerades från moduler. Om formateringsfilen för en modul ändras kan du köra ett Update-FormatData kommando för att uppdatera formateringsdata för importerade kommandon. Du behöver inte importera modulen igen.