Update-FormatData
Hiermee worden de opmaakgegevens in de huidige sessie bijgewerkt.
Syntax
Default (Standaard)
Update-FormatData
[[-AppendPath] <String[]>]
[-PrependPath <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
De cmdlet Update-FormatData laadt de opmaakgegevens van opmaakbestanden opnieuw in de huidige sessie. Met deze cmdlet kunt u de opmaakgegevens bijwerken zonder Windows 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 Windows PowerShell wordt gestart, worden de opmaakgegevens uit de opmaakbestanden in de Installatiemap van Windows PowerShell ($pshome) in de sessie geladen. U kunt Update FormatData gebruiken om de opmaakgegevens opnieuw te laden in de huidige sessie zonder Windows 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 Windows PowerShell.
Voorbeelden
Voorbeeld 1: Eerder geladen opmaakbestanden opnieuw laden
PS C:\> Update-FormatData
Met deze opdracht worden de opmaakbestanden die eerder zijn geladen, opnieuw geladen.
Voorbeeld 2: Opmaakbestanden en tracerings- en logboekopmaakbestanden opnieuw laden
PS C:\> Update-FormatData -AppendPath "trace.format.ps1xml, log.format.ps1xml"
Met deze opdracht worden de opmaakbestanden opnieuw geladen in de sessie, waaronder 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
PS C:\> Update-FormatData -PrependPath "c:\test\NewFiles.format.ps1xml"
# Edit the NewFiles.format.ps1 file.
PS C:\> 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 maakt gebruik van de cmdlet Update-FormatData om de opmaakbestanden opnieuw te laden. Omdat het bestand NewFiles.format.ps1xml 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 Windows PowerShell de ingebouwde opmaakbestanden heeft geladen.
Bij het opmaken van .NET-objecten gebruikt Windows PowerShell de eerste opmaakdefinitie die voor elk .NET-type wordt gevonden. Als u de parameter AppendPath gebruikt, doorzoekt Windows PowerShell de gegevens uit de ingebouwde bestanden voordat deze de opmaakgegevens tegenkomt 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 Windows PowerShell de ingebouwde opmaakbestanden laadt.
Bij het opmaken van .NET-objecten gebruikt Windows PowerShell de eerste opmaakdefinitie die voor elk .NET-type wordt gevonden. Als u de parameter PrependPath gebruikt, doorzoekt Windows 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 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 opdracht Update FormatData uitvoeren om de opmaakgegevens voor geïmporteerde opdrachten bij te werken. U hoeft de module niet opnieuw te importeren.