Update-FormatData

Referentie

Module:: Microsoft.PowerShell.Utility

Updates de opmaakgegevens in de huidige sessie.

Syntax

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

Description

De Update-FormatData cmdlet laadt de opmaakgegevens van opmaakbestanden opnieuw in de huidige sessie. Met deze cmdlet kunt u de opmaakgegevens bijwerken zonder PowerShell opnieuw op te starten.

Zonder parameters worden de opmaakbestanden die eerder zijn geladen, Update-FormatData opnieuw geladen. U kunt de parameters gebruiken om Update-FormatData nieuwe opmaakbestanden aan de sessie toe te voegen.

Het opmaken van bestanden is tekstbestanden in XML-indeling met de format.ps1xml bestandsnaamextensie. De opmaakgegevens in de bestanden definiëren de weergave van Microsoft .NET Framework-objecten in de sessie.

Wanneer PowerShell wordt gestart, worden de indelingsgegevens uit de PowerShell-broncode geladen. U kunt echter aangepaste format.ps1xml-bestanden maken om de opmaak in de huidige sessie bij te werken. U kunt de Update-FormatData opmaakgegevens opnieuw laden in de huidige sessie zonder PowerShell opnieuw te starten. Dit is handig wanneer u een opmaakbestand hebt toegevoegd of gewijzigd, maar de sessie niet wilt onderbreken.

Zie about_Format.ps1xml voor meer informatie over het opmaken van bestanden in PowerShell.

Voorbeelden

Voorbeeld 1: Eerder geladen opmaakbestanden opnieuw laden

Update-FormatData

Met deze opdracht worden de opmaakbestanden die eerder zijn geladen, opnieuw geladen.

Voorbeeld 2: Opmaakbestanden opnieuw laden en opmaakbestanden traceren en logboekopmaakbestanden

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

Met deze opdracht worden de opmaakbestanden opnieuw geladen in de sessie, inclusief twee nieuwe bestanden, Trace.format.ps1xml en Log.format.ps1xml.

Omdat de opdracht gebruikmaakt van de parameter AppendPath , worden de opmaakgegevens in de nieuwe bestanden geladen na de opmaakgegevens uit de ingebouwde bestanden.

De parameter AppendPath wordt gebruikt omdat de nieuwe bestanden opmaakgegevens bevatten voor objecten waarnaar niet wordt verwezen in de ingebouwde bestanden.

Voorbeeld 3: Een opmaakbestand bewerken en opnieuw laden

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

# Edit the NewFiles.format.ps1 file.

Update-FormatData

In dit voorbeeld ziet u hoe u een opmaakbestand opnieuw laadt nadat u het hebt bewerkt.

Met de eerste opdracht wordt het bestand NewFiles.format.ps1xml toegevoegd aan de sessie. De parameter PrependPath wordt gebruikt omdat het bestand opmaakgegevens bevat voor objecten waarnaar wordt verwezen in de ingebouwde bestanden.

Nadat u het bestand NewFiles.format.ps1xml hebt toegevoegd en het in deze sessies hebt getest, bewerkt de auteur het bestand.

De tweede opdracht gebruikt de Update-FormatData cmdlet om de opmaakbestanden opnieuw te laden. Omdat het bestand NewFiles.format.ps1xml eerder is geladen, Update-FormatData wordt het automatisch opnieuw geladen zonder parameters te gebruiken.

Parameters

-AppendPath

Hiermee geeft u opmaakbestanden op die door deze cmdlet worden toegevoegd aan de sessie. De bestanden worden geladen nadat PowerShell de ingebouwde opmaakbestanden heeft geladen.

Wanneer u .NET-objecten opmaakt, gebruikt PowerShell de eerste opmaakdefinitie die wordt gevonden voor elk .NET-type. Als u de parameter AppendPath gebruikt, doorzoekt PowerShell de gegevens uit de ingebouwde bestanden voordat de opmaakgegevens worden weergegeven die u toevoegt.

Gebruik deze parameter om een bestand toe te voegen waarmee een .NET-object wordt opgemaakt waarnaar niet wordt verwezen in de ingebouwde opmaakbestanden.

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

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

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

-PrependPath

Hiermee geeft u opmaakbestanden op die door deze cmdlet worden toegevoegd aan de sessie. De bestanden worden geladen voordat PowerShell de ingebouwde opmaakbestanden laadt.

Wanneer u .NET-objecten opmaakt, gebruikt PowerShell de eerste opmaakdefinitie die wordt gevonden voor elk .NET-type. Als u de parameter PrependPath gebruikt, doorzoekt PowerShell de gegevens uit de bestanden die u toevoegt voordat deze de opmaakgegevens van de ingebouwde bestanden tegenkomt.

Gebruik deze parameter om een bestand toe te voegen waarmee een .NET-object wordt opgemaakt waarnaar ook wordt verwezen in de ingebouwde opmaakbestanden.

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

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

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

Invoerwaarden

String

U kunt een tekenreeks met het toevoegpad doorsluisen naar Update-FormatData.

Uitvoerwaarden

None

De cmdlet retourneert geen uitvoer.

Notities

Update-FormatData werkt ook de opmaakgegevens bij voor opdrachten in de sessie die zijn geïmporteerd uit modules. Als het opmaakbestand voor een module wordt gewijzigd, kunt u een Update-FormatData opdracht uitvoeren om de opmaakgegevens voor geïmporteerde opdrachten bij te werken. U hoeft de module niet opnieuw te importeren.