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




Inhaltsverzeichnis