专业化管理 > 使用属性和命令行实用程序 > 导出和导入首选项 > 导出首选项
  
导出首选项
导出实用程序可导出系统中的所有首选项定义,并允许您指定要导出首选项实例的级别 (站点、组织、上下文或用户)。您可以为整个 Windchill 系统 (默认设置)、特定客户端、特定上下文或特定用户导出首选项实例。
导出操作所生成的输出文件创建在运行实用程序的目录中,名为 PreferenceExport_<YYYYMMDD_HHmm>.xml,其中 <YYYYMMDD_HHmm> 为运行实用程序的日期和时间。
实用程序的语法如下:
windchill wt.preference.ExportPreferences
导出命令支持以下可选参数:
参数
说明
-user="<adminID>"
站点管理员用户的用户 ID此参数应与 -password 参数一同指定。如果未指定这些参数,系统将在运行实用程序时提示您进行身份验证。
-password="<adminpassword>"
站点管理员用户的密码。此参数应与 -user 参数一同指定。如果未指定这些参数,系统将在运行实用程序时提示您进行身份验证。
-usage
显示命令的所有有效参数。
-debug=<debugLevel>
控制信息消息或调试消息的级别。1 为最低级别,3 为最高级别。
-siteLevel
导出所有站点级别的首选项实例。
-orgLevel
-orgLevel="<FullPath>"
如果未指定任何参数值,将导出所有组织的组织级别的所有首选项实例。
如果指定了一个参数值,将导出特定组织的首选项实例。要指定某个组织,必须使用该组织的完全限定名称。可以将多个组织指定为逗号分隔的列表。
例如,要导出一个名为“演示组织”的组织的所有首选项实例,请按以下方式指定参数:
-orgLevel="/wt.inf.container.
OrgContainer=Demo Organization"
如果提供的完全限定名称无效,则会记录一条错误,然后退出命令而不导出任何内容。如果不存在指定级别的首选项实例,则会显示一条消息,但仍会将首选项定义导出到输出文件。
-containerLevel
-containerLevel="<FullPath>"
如果未指定任何参数值,将导出上下文级别 (产品、存储库、项目和项目群) 的所有首选项实例。
如果指定了一个参数值,将导出特定上下文的首选项实例。要指定某个上下文,必须使用该上下文的完全限定名称。可以将多个上下文指定为逗号分隔的列表。
例如,要导出“演示组织”中名为 Product1 的产品的所有首选项实例,请按以下方式指定参数:
-containerLevel="/wt.inf.container.
OrgContainer=Demo Organization/
wt.pdmlink.PDMLinkProduct=
Product1"
如果提供的完全限定名称无效,则会记录一条错误,然后退出命令而不导出任何内容。如果不存在指定级别的首选项实例,则会显示一条消息,但仍会将首选项定义导出到输出文件。
-userLevel="<userId>"
导出以逗号分隔的用户列表的首选项实例。例如,要导出 wcadmin 和 demo 用户的所有首选项实例,请按以下方式指定参数:
-userLevel=wcadmin,demo
-listClients
列出所有首选项客户端以及它们的内部名称。客户端的内部名称用作 -client 参数的值。
如果在指定此参数的同时还指定了其他参数,则会显示客户端列表,但该命令不会执行其他任何操作。
-client=<ClientName>
导出指定客户端的首选项实例。必须将客户端的内部名称 (显示在 -listClients 参数的输出中) 指定为参数值。只能为此参数指定一个值。
如果未指定此参数,将导出 Windchill 客户端的首选项实例。
-printEffectiveValues
输出指定级别和客户端的有效首选项值。此参数必须与一个级别参数 (-siteLevel-orgLevel-containerLevel-userLevel) 结合使用。如果已指定多个级别参数或未指定任何级别参数,则会显示一条错误消息,然后退出命令而不导出任何内容。
如果已指定 -client 参数,则只会导出该客户端的有效值。如果未指定客户端,将输出客户端 WINDCHILL 的有效值。
使用此参数运行导出命令时,将创建以下输出文件,而不是标准输出文件:
PrefEffectiveValues_
<YYYYMMDD_HHmm>.csv
,其中 <YYYYMMDD_HHmm> 为运行命令的日期和时间。
* 
有效值是指在指定级别有效的首选项值,而无论是在该级别指定首选项实例,还是从更高级别继承首选项实例。
-onlyInstances
仅导出首选项实例。不导出任何首选项定义、首选项类别或首选项客户端。
-excludeHiddenInstances
不导出可见性设为“隐藏”(HIDDEN) 的首选项实例。