匯出偏好設定
匯出公用程式可匯出系統中的所有偏好設定定義，並可讓您指定所要匯出之偏好設定實例的層級 (網站、組織、前後關聯或使用者)。您也可以對整個 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>"
|
如果沒有使用參數值指定，則會針對所有組織匯出組織層級的所有偏好設定實例。
如果使用參數值指定，則會針對指定組織匯出偏好設定實例。欲指定組織，必須使用完全合格的組織名稱。可以將多個組織指定為用逗號分隔的清單。
例如，欲針對名為 Demo Organization 的組織匯出所有偏好設定實例，請以下列方式指定參數：
-orgLevel="/wt.inf.container.
OrgContainer=Demo Organization" 如果提供的完全合格名稱無效，則會記錄下錯誤，且指令會結束而不匯出任何內容。如果指定層級不存在任何偏好設定實例，則會顯示訊息，但仍會將偏好設定定義匯出至輸出檔案。
|
||
|
-containerLevel
-containerLevel="<FullPath>"
|
如果沒有使用參數值指定，則會匯出前後關聯層級 (產品、物件庫、專案與方案) 的所有偏好設定實例。
如果使用參數值指定，則會針對指定前後關聯匯出偏好設定實例。欲指定前後關聯，必須使用完全合格的前後關聯名稱。可以將多個前後關聯指定為用逗號分隔的清單。
例如，欲針對 Demo Organization 中名為 Product1 的產品匯出所有偏好設定實例，請以下列方式指定參數：
-containerLevel="/wt.inf.container.
OrgContainer=Demo Organization/ wt.pdmlink.PDMLinkProduct= Product1" 如果提供的完全合格名稱無效，則會記錄下錯誤，且指令會結束而不匯出任何內容。如果指定層級不存在任何偏好設定實例，則會顯示訊息，但仍會將偏好設定定義匯出至輸出檔案。
|
||
|
-userLevel="<使用者 Id>"
|
可針對逗號分隔的使用者清單匯出偏好設定實例。例如，欲針對 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) 之偏好設定的實例。
|
