特定管理 > 利用屬性與指令行公用程式 > 匯出與匯入偏好設定 > 匯出偏好設定
  
匯出偏好設定
匯出公用程式可匯出系統中的所有偏好設定定義,並可讓您指定所要匯出之偏好設定實例的層級 (網站、組織、前後關聯或使用者)。您也可以對整個 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) 之偏好設定的實例。