Dela via

Update-FormatData

  • Referens
Modul:
Microsoft.PowerShell.Utility

Uppdateringar formateringsdata i den aktuella sessionen.

Syntax

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

Description

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

Utan parametrar läser Update-FormatData in formateringsfilerna som lästes in tidigare. Du kan använda parametrarna för Update-FormatData 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 Windows PowerShell startar läses formatdata från formateringsfilerna i Windows PowerShell installationskatalogen ($pshome) in i sessionen. Du kan använda Update-FormatData för att läsa in formateringsdata i den aktuella sessionen igen utan att starta om Windows 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 Windows PowerShell finns i about_Format.ps1xml.

Exempel

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

PS C:\> 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

PS C:\> 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

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

# Edit the NewFiles.format.ps1 file.

PS C:\> 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 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 automatiskt in den igen utan att använda parametrar.

Parametrar

-AppendPath

Anger formatering av filer som denna cmdlet lägger till i sessionen. Filerna läses in när Windows PowerShell läser in de inbyggda formateringsfilerna.

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

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

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

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PrependPath

Anger formatering av filer som denna cmdlet lägger till i sessionen. Filerna läses in innan Windows PowerShell läser in de inbyggda formateringsfilerna.

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

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

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

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Indata

String

Du kan skicka en sträng som innehåller tilläggssökvägen till Update-FormatData.

Utdata

None

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 kommandot Update-FormatData för att uppdatera formateringsdata för importerade kommandon. Du behöver inte importera modulen igen.