Export-FormatData
Hiermee worden opmaakgegevens uit de huidige sessie opgeslagen in een opmaakbestand.
Syntaxis
ByPath (Standaard)
Export-FormatData
-InputObject <ExtendedTypeDefinition[]>
-Path <String>
[-Force]
[-NoClobber]
[-IncludeScriptBlock]
[<CommonParameters>]
ByLiteralPath
Export-FormatData
-InputObject <ExtendedTypeDefinition[]>
-LiteralPath <String>
[-Force]
[-NoClobber]
[-IncludeScriptBlock]
[<CommonParameters>]
Description
Met de cmdlet Export-FormatData worden PowerShell-opmaakbestanden (format.ps1xml) gemaakt op basis van de opmaakobjecten in de huidige sessie. De ExtendedTypeDefinition objecten die Get-FormatData retourneert en opslaat in een bestand in XML-indeling.
PowerShell gebruikt de gegevens in opmaakbestanden (format.ps1xml) om de standaardweergave van Microsoft .NET Framework-objecten in de sessie te genereren. U kunt de opmaakbestanden weergeven en bewerken en de cmdlet Update-FormatData gebruiken om de opmaakgegevens toe te voegen aan een sessie.
Zie about_Format.ps1xmlvoor meer informatie over het opmaken van bestanden in PowerShell.
Voorbeelden
Voorbeeld 1: Gegevens in sessieindeling exporteren
Get-FormatData -TypeName "*" |
Export-FormatData -Path "AllFormat.ps1xml" -IncludeScriptBlock
Met deze opdracht worden alle indelingsgegevens in de sessie geëxporteerd naar het AllFormat.ps1xml-bestand.
De opdracht gebruikt de Get-FormatData-cmdlet om de indelingsgegevens in de sessie op te halen. Met een waarde van * (alle) voor de parameter TypeName wordt de cmdlet om alle gegevens in de sessie opgehaald.
De opdracht maakt gebruik van een pijplijnoperator (|) om de indelingsgegevens van de opdracht Get-FormatData te verzenden naar de Export-FormatData-cmdlet, waarmee de indelingsgegevens naar het AllFormat.ps1xml-bestand worden geëxporteerd.
De opdracht Export-FormatData maakt gebruik van de parameter IncludeScriptBlock om scriptblokken op te nemen in de indelingsgegevens in het bestand.
Voorbeeld 2: Gegevens exporteren voor een type
$F = Get-FormatData -TypeName "HelpInfoShort"
Export-FormatData -InputObject $F -Path "C:\test\Help.format.ps1xml" -IncludeScriptBlock
Met deze opdrachten worden de indelingsgegevens voor de HelpInfoShort- naar het Help.format.ps1xml-bestand geëxporteerd.
De eerste opdracht maakt gebruik van de Get-FormatData-cmdlet om de indelingsgegevens voor het HelpInfoShort--type op te halen en slaat deze op in de $F variabele.
De tweede opdracht maakt gebruik van de parameter InputObject van de Export-FormatData-cmdlet om de indelingsgegevens in te voeren die zijn opgeslagen in de variabele $F. Ook wordt de parameter IncludeScriptBlock gebruikt om scriptblokken op te nemen in de uitvoer.
Voorbeeld 3: Gegevens exporteren zonder scriptblok
Get-FormatData -TypeName "System.Diagnostics.Process" |
Export-FormatData -Path Process.format.ps1xml
Update-FormatData -PrependPath ".\Process.format.ps1xml"
Get-Process p*
Handles NPM(K) PM(K) WS(K) VM(M) CPU(s) Id ProcessName
------- ------ ----- ----- ----- ------ -- -----------
323 5600 powershell
336 3900 powershell_ise
138 4076 PresentationFontCache
In dit voorbeeld ziet u het effect van het weglaten van de IncludeScriptBlock parameter uit een Export-FormatData opdracht.
De eerste opdracht maakt gebruik van de Get-FormatData cmdlet om de indelingsgegevens op te halen voor het System.Diagnostics.Process object dat de Get-Process cmdlet retourneert. De opdracht maakt gebruik van een pijplijnoperator (|) om de opmaakgegevens te verzenden naar de Export-FormatData-cmdlet, waarmee deze wordt geëxporteerd naar het Process.format.ps1xml bestand in de huidige map.
In dit geval gebruikt de opdracht Export-FormatData niet de parameter IncludeScriptBlock.
De tweede opdracht maakt gebruik van de Update-FormatData cmdlet om het Process.format.ps1xml bestand toe te voegen aan de huidige sessie. De opdracht gebruikt de parameter PrependPath om ervoor te zorgen dat de opmaakgegevens voor procesobjecten in het bestand Process.format.ps1xml worden gevonden voordat de standaardopmaakgegevens voor procesobjecten worden gevonden.
De derde opdracht toont de effecten van deze wijziging. De opdracht gebruikt de Get-Process cmdlet om processen op te halen met namen die beginnen met P. In de uitvoer ziet u dat eigenschapswaarden die worden berekend met behulp van scriptblokken ontbreken in de weergave.
Parameters
-Force
Hiermee dwingt u de opdracht uit te voeren zonder dat u om bevestiging van de gebruiker wordt gevraagd.
Parametereigenschappen
| Type: | SwitchParameter |
| 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 |
-IncludeScriptBlock
Hiermee wordt aangegeven of scriptblokken in de indelingsgegevens worden geëxporteerd.
Omdat scriptblokken code bevatten en schadelijk kunnen worden gebruikt, worden ze niet standaard geëxporteerd.
Parametereigenschappen
| Type: | SwitchParameter |
| 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 |
-InputObject
Hiermee geeft u de indeling van gegevensobjecten die moeten worden geëxporteerd. Voer een variabele in die de objecten bevat of een opdracht waarmee de objecten worden opgehaald, zoals een Get-FormatData opdracht. U kunt de objecten ook van Get-FormatData naar Export-FormatDatadoorsluisen.
Parametereigenschappen
| Type: | |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | True |
| Waarde uit pijplijn: | True |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-LiteralPath
Hiermee geeft u een locatie voor het uitvoerbestand. In tegenstelling tot de parameter Path, wordt de waarde van LiteralPath- exact gebruikt zoals deze is getypt. Er worden geen tekens geïnterpreteerd als jokertekens. Als het pad escape-tekens bevat, zet het dan tussen enkele aanhalingstekens. Enkele aanhalingstekens zorgen ervoor dat PowerShell geen tekens als escapesequenties interpreteert.
Parametereigenschappen
| Type: | String |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
| Aliassen: | PSPath, LP |
Parametersets
ByLiteralPath
| Position: | Named |
| Verplicht: | True |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-NoClobber
Geeft aan dat de cmdlet bestaande bestanden niet overschrijft. Standaard overschrijft Export-FormatData bestanden zonder waarschuwing, tenzij het bestand het kenmerk Alleen-lezen heeft.
Als u Export-FormatData wilt om bestanden met het kenmerk Alleen-lezen te overschrijven, gebruikt u de parameter Force.
Parametereigenschappen
| Type: | SwitchParameter |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
| Aliassen: | NoOverwrite |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-Path
Hiermee geeft u een locatie voor het uitvoerbestand. Voer een pad (optioneel) en bestandsnaam in met een format.ps1xml bestandsnaamextensie. Als u het pad weglaat, maakt Export-FormatData het bestand in de huidige map.
Als u een andere bestandsnaamextensie dan .ps1xmlgebruikt, herkent de Update-FormatData cmdlet het bestand niet.
Als u een bestaand bestand opgeeft, overschrijft Export-FormatData het bestand zonder waarschuwing, tenzij het bestand het kenmerk Alleen-lezen heeft. Als u een alleen-lezenbestand wilt overschrijven, gebruikt u de parameter Forceren. Als u wilt voorkomen dat bestanden worden overschreven, gebruikt u de parameter NoClobber.
Parametereigenschappen
| Type: | String |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
| Aliassen: | FilePath |
Parametersets
ByPath
| Position: | Named |
| Verplicht: | True |
| 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
ExtendedTypeDefinition
U kunt ExtendedTypeDefinition objecten van Get-FormatData naar deze cmdlet doorsluisen.
Uitvoerwaarden
None
Deze cmdlet retourneert geen uitvoer. Er wordt een bestand gegenereerd en opgeslagen in het opgegeven pad.
Notities
- Als u een opmaakbestand, inclusief een geëxporteerd opmaakbestand, wilt gebruiken, moet het uitvoeringsbeleid voor de sessie toestaan dat scripts en configuratiebestanden worden uitgevoerd. Zie about_Execution_Policiesvoor meer informatie.
