Erstellt eine XML-Darstellung von Objekten und speichert sie in einer Datei.
Syntax
Export-Clixml [-Path] <string> -InputObject <psobject> [-Depth <int>] [-Encoding <string>] [-Force] [-NoClobber] [-Bestätigung] [-WhatIf] [<CommonParameters>]
Beschreibung
Mit dem Cmdlet "Export-Clixml" wird eine XML-Darstellung von Objekten erstellt und in einer Datei gespeichert. Anschließend können Sie mit dem Cmdlet "Import-CLIXML" das gespeicherte Objekt anhand des Inhalts dieser Datei neu erstellen.
Dieses Cmdlet ähnelt ConvertTo-XML, jedoch wird mit Export-Clixml der resultierende XML-Inhalt in einer Datei gespeichert. ConvertTo-XML gibt den XML-Inhalt zurück, sodass Sie diesen anschließend in Windows PowerShell verarbeiten können.
Parameter
-Depth <int>
Gibt an, wie viele Ebenen enthaltener Objekte in die XML-Darstellung eingeschlossen werden. Der Standardwert ist 2.
Der Standardwert für den Objekttyp kann in der Datei "Types.ps1xml" überschrieben werden. Weitere Informationen finden Sie unter "about_Types.ps1xml".
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
2 |
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
-Encoding <string>
Gibt den Typ der Codierung für die Zieldatei an. Gültige Werte sind "ASCII", "UTF8", "UTF7", "UTF32", "Unicode", "BigEndianUnicode", "Default" und "OEM". Der Standardwert ist "UTF8".
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
UTF8 |
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
-Force
Bewirkt, dass das Cmdlet das Schreibschutzattribut der Ausgabedatei ggf. löscht. Das Cmdlet versucht, das Schreibschutzattribut nach der Ausführung des Befehls zurückzusetzen.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
-InputObject <psobject>
Gibt das zu konvertierende Objekt an. Geben Sie eine Variable ein, die die Objekte enthält, oder geben Sie einen Befehl oder einen Ausdruck ein, mit dem die Objekte abgerufen werden. Sie können Objekte auch über die Pipeline an Export-Clixml übergeben.
|
Erforderlich? |
true |
|
Position? |
named |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
true (ByValue) |
|
Platzhalterzeichen akzeptieren? |
false |
-NoClobber
Verhindert, dass das Cmdlet den Inhalt einer vorhandenen Datei überschreibt. Standardmäßig wird mit Export-Clixml eine unter dem angegebenen Pfad vorhandene Datei ohne Warnung überschrieben.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
-Path <string>
Gibt den Pfad der Datei an, in der die XML-Darstellung des Objekts gespeichert wird.
|
Erforderlich? |
true |
|
Position? |
1 |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
-Bestätigung
Fordert Sie vor der Ausführung des Befehls zur Bestätigung auf.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
-WhatIf
Beschreibt die Auswirkungen einer Ausführung des Befehls, ohne den Befehl tatsächlich auszuführen.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
<CommonParameters>
Dieses Cmdlet unterstützt die folgenden allgemeinen Parameter: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer und -OutVariable. Weitere Informationen finden Sie unter about_Commonparameters.
Eingaben und Ausgaben
Der Eingabetyp ist der Typ der Objekte, die über die Pipeline an das Cmdlet übergeben werden können. Der Rückgabetyp ist der Typ der Objekte, die das Cmdlet zurückgibt.
|
Eingaben |
System.Management.Automation.PSObject Sie können jedes Objekt über die Pipeline an Export-Clixml übergeben. |
|
Ausgaben |
System.IO.FileInfo Export-Clixml erstellt eine Datei, die den XML-Inhalt enthält. |
Beispiel 1
C:\PS>"This is a test" | export-clixml sample.xml Beschreibung ----------- Mit diesem Befehl wird eine XML-Datei erstellt, in der eine Darstellung der Zeichenfolge "This is a test" gespeichert wird.
Beispiel 2
C:\PS>get-acl C:\test.txt | export-clixml -Path fileacl.xml C:\PS> $fileacl = import-clixml fileacl.xml Beschreibung ----------- In diesem Beispiel wird gezeigt, wie ein Objekt in eine XML-Datei exportiert wird und dann durch Importieren des XML-Inhalts aus der Datei ein Objekt erstellt wird. Im ersten Befehl wird das Cmdlet "Get-ACL" verwendet, um die Sicherheitsbeschreibung der Datei "Test.txt" abzurufen. Die Sicherheitsbeschreibung wird mit dem Pipelineoperator an Export-Clixml übergeben, und dieses Cmdlet speichert eine XML-Darstellung des Objekts in einer Datei mit dem Namen "FileACL.xml". Im zweiten Befehl wird aus dem XML-Inhalt der Datei "FileACL.xml" mit dem Cmdlet "Import-Clixml" ein Objekt erstellt. Dann wird das Objekt in der Variablen "$FileAcl" gespeichert.
Siehe auch