Export-Clixml

Export to an XML file, any text string or PowerShell object can be represented in XML.

Syntax
      Export-Clixml [-path] string -inputObject psobject
         [-depth int] [-force] [-encoding string]
            [-noClobber] [-whatIf] [-confirm] [CommonParameters]

Key
   -Path string
        The XML file to be created.

   -inputObject psobject
        The object to be converted. {may be piped}
        A variable containing the object(s) 
        or a command/expression that returns the object(s).

   -depth int 
        How many levels of contained objects to include in the XML
        A depth of 1 will include Object > properties
        a depth of 2 will include Object > properties >Objects >Properties
        and so on *

   -force
       Override restrictions that prevent the command from succeeding, apart
       from security settings. e.g. Force will override a files read-only attribute,
       but will attempt to reset the read-only attribute when the command completes.
	   
    -noClobber
       Do not overwrite the contents of an existing file.
       The default is to overwrite without warning.
		 
    -encoding string
       The type of encoding for the target file. Valid values are:
       ASCII, UTF8, UTF7, UTF32, Unicode, BigEndianUnicode, Default, and OEM.
        
   -whatIf
       Describe what would happen if you executed the command without actually
       executing the command.
       
   -confirm
       Prompt for confirmation before executing the command.
 
   CommonParameters:
       -Verbose, -Debug, -ErrorAction, -ErrorVariable, -WarningAction, -WarningVariable,
       -OutBuffer -OutVariable.

* If the object being exported has a type-specific depth (specified in the *.types.psxml file), then that depth will be used unless you specify the -Depth parameter.

Examples

Create an XML file that represents the string, "This text will become XML"

PS C:> "This text will become XML" | export-clixml c:\SimpleDemo.xml

Use Get-Acl to retrieve an object containg the ACLs (security descriptors) for a file, and pipe the result into an XML file.

PS C:> get-acl C:\ss64.txt | export-clixml -Path E:\ss64_acl.xml

Retrieve the ACL object from a saved XML file and store in the variable $my_acl:

PS C:> $my_acl = import-clixml E:\ss64_acl.xml

"Beware the man of one book" ~ St. Thomas Aquinas

Related:

import-clixml - Import a clixml file and rebuild the PS object
export-csv - Export to Comma Separated Values (spreadsheet)
convertTo-Html - Convert the input into an HTML table


© Copyright SS64.com 1999-2014
Some rights reserved