特定管理 > 利用屬性與指令行公用程式 > 匯出與匯入偏好設定 > 匯入偏好設定
  
匯入偏好設定
匯入公用程式可讓您匯入之前匯出的偏好設定資訊。您可以對其從匯出檔案所匯入的偏好設定實例進行限制；例如，您可以只匯入特定使用者或前後關聯的偏好設定實例。您也可以選擇將匯入的偏好設定實例套用至特定層級，例如特定組織或使用者。在此情況下，只會針對在 -applyTo 參數中指定的層級建立偏好設定實例。不會建立對應於所匯入偏好設定實例之原始層級的偏好設定實例。
匯入指令的語法如下：
windchill wt.preference.ImportPreferences -importfile="<檔案路徑>"
執行匯入公用程式時，會在執行工具的目錄中建立記錄檔，名為 PreferenceImport_<YYYYMMDD_HHmm>.txt，其中 <YYYYMMDD_HHmm> 是執行公用程式的日期與時間。在現有偏好設定資訊與匯入的偏好設定資訊之間，若有任何不符之處，都會標記為衝突並在 PreferenceImportConflicts_<YYYYMMDD_HHmm>.txt 記錄檔中記錄，此檔案也會建立在執行工具時所在的目錄中。
在指令中，有支援判定此類衝突會發生什麼結果的參數。也會記錄新偏好設定定義與實例。如果在匯入的偏好設定實例中並未指定對應的偏好設定定義、類別或用戶端，則會將其標記為錯誤並記錄下來。如果有偏好設定定義，但在較所匯入定義試圖套用之層級的更高層級上已有偏好設定定義，則會記錄錯誤。
如果遇到任何錯誤，則會處理整個匯入檔案、記錄所有錯誤，且公用程式會結束而不匯入任何偏好設定實例。
如果沒有遇到不符或錯誤的情況，則匯入會成功完成。
匯入指令支援下列參數：
參數
描述
-importfile="<檔案路徑>"
從中匯入偏好設定的 XML 檔案，包含完整檔案路徑。這通常是使用偏好設定匯出公用程式建立的檔案。如果提供了無效檔案或檔案路徑，則會顯示錯誤訊息。
必須使用這個參數。
-user="<adminID>"
網站管理員使用者的使用者 ID。此參數應與 -password 參數一起指定。若未指定這些參數，執行公用程式時，系統將會提示進行驗證。
-password="<adminpassword>"
網站管理員使用者的密碼。此參數應與 -user 參數一起指定。若未指定這些參數，執行公用程式時，系統將會提示進行驗證。
-usage
顯示指令的所有有效引數。
-debug="<debugLevel>"
控制資訊或偵錯訊息的層級。1 為最低，3 為最高。
-importSiteLevel
只從匯入檔案中匯入網站層級偏好設定實例。
一次只能指定以下其中一個參數：-importSiteLevel、-importOrgLevel、-importContainerLevel 或 -importUserLevel。
如果匯入檔案中不存在指定層級的偏好設定實例，則會將資訊訊息新增到記錄中，但不會將它視為錯誤。
-importOrgLevel="<FullPath>"
僅從匯入檔案匯入指定組織的偏好設定實例。一次只能指定一個組織。必須將組織的完全合格路徑指定為參數值。
例如，欲針對名為 Demo Organization 的組織匯入偏好設定實例，請以下列方式指定參數：
-importOrgLevel="/wt.inf.container.OrgContainer=Demo Organization"
一次只能指定以下其中一個參數：-importSiteLevel、-importOrgLevel、-importContainerLevel 或 -importUserLevel。
如果匯入檔案中不存在指定層級的偏好設定實例，則會將資訊訊息新增到記錄中，但不會將它視為錯誤。
-importContainerLevel="<FullPath>"
僅從匯入檔案中匯入指定前後關聯 (產品、物件庫、專案或方案) 的偏好設定實例。一次只能指定一個前後關聯。必須將前後關聯的完全合格路徑指定為參數值。
例如，欲針對 Demo Organization 中名為 Product1 的產品匯入所有偏好設定實例，請以下列方式指定參數：
-importContainerLevel="/wt.inf.container.OrgContainer=Demo Organization/wt.pdmlink.PDMLinkProduct=Product1"
一次只能指定以下其中一個參數：-importSiteLevel、-importOrgLevel、-importContainerLevel 或 -importUserLevel。
如果匯入檔案中不存在指定層級的偏好設定實例，則會將資訊訊息新增到記錄中，但不會將它視為錯誤。
-importUserLevel=<使用者 Id>
僅從匯入檔案匯入指定使用者的偏好設定實例。一次只能指定一個使用者。例如，欲針對 wcadmin 使用者匯入所有偏好設定實例，請以下列方式指定參數：
-userLevel=wcadmin
一次只能指定以下其中一個參數：-importSiteLevel、-importOrgLevel、-importContainerLevel 或 -importUserLevel。
如果匯入檔案中不存在指定層級的偏好設定實例，則會將資訊訊息新增到記錄中，但不會將它視為錯誤。
-overwriteValueConflicts
所有值不相符的衝突都透過以匯入的值覆寫現有值來解決。如果指定此參數，則會用匯入的偏好設定值取代資料庫中的任何多值偏好設定。
此偏好設定可與 -skipUnresolvedConflicts 偏好設定一起指定，在此情況下，匯入操作應在覆寫所有值衝突的情況下成功完成，並略過所有未解決的衝突，
-skipUnresolvedConflicts
會略過未解決的任何衝突。會匯入其餘檔案。
此偏好設定可與 -overwriteValueConflicts 偏好設定一起指定，在此情況下，匯入操作應在覆寫所有值衝突的情況下成功完成，並略過所有未解決的衝突，
-applyToSiteLevel
僅將匯入的偏好設定實例套用至網站層級。
-applyToOrgLevel="<FullPath>"
僅將匯入的偏好設定實例套用至指定的組織。參數值必須是組織的完全合格路徑。可以將多個組織指定為用逗號分隔的清單。
此參數只能搭配以下其中一個參數使用：-importSiteLevel、-importOrgLevel、-importContainerLevel 或 -importUserLevel。
若已指定多個組織，則會將匯入操作分別套用至每一個組織。如果某些指定的組織能夠成功完成匯入，但其他組織不能，則會顯示訊息詳細指出成功匯入的組織。匯入失敗之組織中的任何衝突都會記錄到記錄檔中。
-applyToContainerLevel="<FullPath>"
僅將匯入的偏好設定實例套用到指定的一或多個前後關聯 (產品、物件庫、專案或方案)。參數值必須是前後關聯的完全合格路徑。可以將多個前後關聯指定為用逗號分隔的清單。
此參數只能搭配以下其中一個參數使用：-importSiteLevel、-importOrgLevel、-importContainerLevel 或 -importUserLevel。
若已指定多個前後關聯，則會將匯入操作分別套用至每一個前後關聯。如果某些指定的前後關聯能夠成功完成匯入，但其他前後關聯不能，則會顯示訊息詳細指出成功匯入的前後關聯。不匯入失敗之前後關聯中的任何衝突都會記錄到記錄檔中。
-applyToUserLevel="<使用者 Id>"
僅將匯入的偏好設定實例套用至指定的一或多個使用者。可以將多個使用者指定為用逗號分隔的清單。
此參數只能搭配以下其中一個參數使用：-importSiteLevel、-importOrgLevel、-importContainerLevel 或 -importUserLevel。
若已指定多個使用者，則會將匯入操作分別套用至每一位使用者。如果某些指定的使用者能夠成功完成匯入，但其他使用者不能，則會顯示訊息詳細指出成功匯入的使用者。匯入失敗之使用者中的任何衝突都會記錄到記錄檔中。