Export-Clixml 帮助信息

如下说明是翻译 : help Export-Clixml 产生的帮助信息 .

译者 : Edengundam( 马涛 )

 

Export-Clixml

 

摘要

为一个或多个对象创建基于 XML 的表示形式 , 并将其存储在文件中 .

 

语法

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

 

详细描述

为一个或多个对象创建基于 XML 的表示形式 , 并将其存储在文件中 . 你可以通过使用 Import-CLIXML cmdlet 根据文件内容恢复并保存这些对象 .

 

参数

 

-path <string>

指定存储对象的 XML 表示形式文件的路径 .

 

强制参数 ?	true
参数位置 ?	1
默认值
允许从管道绑定输入 ?	false
允许通配符扩展 ?	true

 

-inputObject <psobject>

指定需要转换的对象 . 输入一个包含对象的变量 , 或者一个能够产生对象的命令或表达式 .

 

强制参数 ?	true
参数位置 ?	named
默认值
允许从管道绑定输入 ?	true ( 根据值 )
允许通配符扩展 ?	false

 

-depth <int>

指定 XML 表示中应该包含多少对象层次 . 被导出的对象中某些属性本身可能也是对象 . 如果你希望在 XML 表示中存储这些表示属性的对象 , 你必须指定深度为 2. 被包含的对象本身可能还包含其他表示其属性的对象 . 要在 XML 表示中保存表示这些属性的对象你需要将深度增加为 3, 以此类推 . 如果被导出的对象在 *.types.psxml 文件有对象的深度设置 , 并且你又没有指定 Depth 参数 , 那么 PowerShell 将使用这些文件中的深度 .

 

强制参数 ?	false
参数位置 ?	named
默认值
允许从管道绑定输入 ?	false
允许通配符扩展 ?	false

 

-force <SwitchParameter>

在不破坏安全性的前提下 , 能够避免影响命令成功执行的限制条件 . 此 cmdlet 将会在命令完成会尝试恢复文件的只读属性 .

 

强制参数 ?	false
参数位置 ?	named
默认值
允许从管道绑定输入 ?	false
允许通配符扩展 ?	false

 

-encoding <string>

为目标文件指定编码类型 . 合法值 : ASCII, UTF8, UTF7, UTF32, Unicode, BigEndianUnicode, Default 和 OEM.

 

强制参数 ?	false
参数位置 ?	named
默认值
允许从管道绑定输入 ?	false
允许通配符扩展 ?	false

 

-noClobber <SwitchParameter>

不覆盖 ( 替换原有内容 ) 已经存在的文件 . 默认情况下 , 如果文件已经在指定路径存在 , Export-Clixml 不提示任何警告 , 将其覆盖 .

 

强制参数 ?	false
参数位置 ?	named
默认值	False
允许从管道绑定输入 ?	false
允许通配符扩展 ?	false

 

-whatIf

描述执行此命令将会发生的现象 , 不会真正执行此命令 .

 

强制参数 ?	false
参数位置 ?	named
默认值
允许从管道绑定输入 ?	false
允许通配符扩展 ?	false

 

-confirm

执行命令前提示你进行确认 .

 

强制参数 ?	false
参数位置 ?	named
默认值
允许从管道绑定输入 ?	false
允许通配符扩展 ?	false

 

< 公共参数 >

此命令支持公共参数 : -Verbose, -Debug, -ErrorAction, -ErrorVariable 和 -OutVariable. 更多信息 , 输入 , "get-help about_commonparameters".

 

输入类型

Object

 

注意

 

更多信息 , 输入 "Get-Help Export-Clixml -detailed". 需要技术信息 , 输入 "Get-Help Export-Clixml -full".

 

如果需要为该命令提供多个参数 , 请使用逗号进行分隔 . 例如 , "<parameter-name> <value1>, <value2>".

 

例 1

 

C:/PS>"This is a test" | export-clixml smpl.xml

 

此命令创建一个 XML 文件用来存储字符串 "This is a test" 的 xml 表示形式 .

 

例 2

 

C:/PS>get-acl C:/test.txt | export-clixml -Path testacl.xml

$testacl = import-clixml testacl.xml

 

此命令存储 Get-Acl cmdlet 返回对象的 XML 表示 , 返回的对象包含了表示 C:/test.txt 文件的安全描述符信息 . Get-Acl 的输出通过管道传递给 Export-Clixml, 后者将对象以 XML 表示形式存储到名为 testacl.xml 的文件 . 命令的第二行中 , Import-Clixml cmdlet 用来取得存储的表示形式 , 并重新创建对象 . 最后将重建的对象存储在变量 $testacl 中 .

 

相关链接

Import-Clixml

Export-Csv

ConvertTo-Html