Update-FormatData
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 te starten.
Zonder parameters worden Update-FormatData
de opmaakbestanden die eerder zijn geladen, opnieuw geladen.
U kunt de parameters van Update-FormatData
gebruiken om nieuwe opmaakbestanden toe te voegen aan de sessie.
Opmaakbestanden zijn tekstbestanden in XML-indeling met de format.ps1xml
bestandsextensie. 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 gebruiken Update-FormatData
om de opmaakgegevens opnieuw in de huidige sessie te laden 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 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 de parameter AppendPath gebruikt, 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. Er wordt gebruikgemaakt van de parameter PrependPath omdat het bestand opmaakgegevens bevat voor objecten waarnaar wordt verwezen in de ingebouwde bestanden.
Nadat het bestand NewFiles.format.ps1xml is toegevoegd en getest in deze sessies, 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 met deze cmdlet worden toegevoegd aan de sessie. De bestanden worden geladen nadat PowerShell de ingebouwde opmaakbestanden heeft geladen.
Bij het opmaken van .NET-objecten 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 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.
Type: | String[] |
Aliases: | PSPath, Path |
Position: | 0 |
Default value: | None |
Required: | False |
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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PrependPath
Hiermee geeft u opmaakbestanden op die met deze cmdlet worden toegevoegd aan de sessie. De bestanden worden geladen voordat powershell de ingebouwde opmaakbestanden laadt.
Bij het opmaken van .NET-objecten gebruikt PowerShell de eerste opmaakdefinitie die wordt gevonden voor elk .NET-type. Als u de parameter PrependPath gebruikt, zoekt PowerShell de gegevens uit de bestanden die u toevoegt voordat de opmaakgegevens uit de ingebouwde bestanden worden gevonden.
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 |
Required: | False |
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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Invoerwaarden
U kunt een tekenreeks met het toevoegpad doorsnijden 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 eenUpdate-FormatData
opdracht uitvoeren om de opmaakgegevens voor geïmporteerde opdrachten bij te werken. U hoeft de module niet opnieuw te importeren.