Delen via

Update-FormatData

Module:
Microsoft.PowerShell.Utility Module

Hiermee worden de opmaakgegevens in de huidige sessie bijgewerkt.

Syntaxis

Default (Standaard) 

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, opnieuw geladen Update-FormatData. U kunt de parameters van Update-FormatData gebruiken om nieuwe opmaakbestanden aan de sessie toe te voegen.

Opmaakbestanden zijn tekstbestanden in XML-indeling met de bestandsextensie format.ps1xml. 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 Update-FormatData gebruiken om de opmaakgegevens opnieuw te 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.ps1xmlvoor 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 en tracerings- en logboekopmaakbestanden opnieuw laden

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 NewFiles.format.ps1xml-bestand aan de sessie toegevoegd. De parameter PrependPath wordt gebruikt omdat het bestand opmaakgegevens bevat voor objecten waarnaar wordt verwezen in de ingebouwde bestanden.

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

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

Parameters

-AppendPath

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

Bij het opmaken van .NET-objecten gebruikt PowerShell de eerste opmaakdefinitie die voor elk .NET-type wordt gevonden. Als u de parameter AppendPath gebruikt, doorzoekt PowerShell de gegevens uit de ingebouwde bestanden voordat de opmaakgegevens worden gevonden 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.

Parametereigenschappen

Type:

String[]

Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:PSPath, Path

Parametersets

(All)
Position:0
Verplicht:False
Waarde uit pijplijn:True
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-Confirm

Voordat u de cmdlet uitvoert, vraagt het systeem om bevestiging.

Parametereigenschappen

Type:SwitchParameter
Default value:False
Ondersteunt jokertekens:False
DontShow:False
Aliassen:Cf

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-PrependPath

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

Bij het opmaken van .NET-objecten gebruikt PowerShell de eerste opmaakdefinitie die voor elk .NET-type wordt gevonden. Als u de parameter PrependPath gebruikt, doorzoekt PowerShell de gegevens uit de bestanden die u toevoegt voordat de opmaakgegevens van de ingebouwde bestanden worden tegengekomen.

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

Parametereigenschappen

Type:

String[]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-WhatIf

Toont wat er zou gebeuren wanneer de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Parametereigenschappen

Type:SwitchParameter
Default value:False
Ondersteunt jokertekens:False
DontShow:False
Aliassen:Wi

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

CommonParameters

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

Invoerwaarden

String

U kunt een tekenreeks met het toevoegpad naar deze cmdlet doorsluisen.

Uitvoerwaarden

None

Deze 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.