Import-CsConfiguration
上次修改主題的時間： 2012-03-23
將您的 Microsoft Lync Server 2010 拓撲、原則及組態設定匯入至中央管理存放區或本機電腦。
語法
Import-CsConfiguration -ByteInput <Byte[]> [-Force <SwitchParameter>] [-LocalStore <SwitchParameter>]
Import-CsConfiguration -FileName <String> [-Force <SwitchParameter>] [-LocalStore <SwitchParameter>]
詳細描述
執行 Lync Server 2010 服務或伺服器角色的電腦必須擁有目前拓撲的複本、目前的組態設定及目前的原則等等，才能夠以其指定的角色運作。Lync Server 負責確保此資訊會傳送到每部需要它的電腦。
使用 Import-CsConfiguration 和 Export-CsConfiguration 指令程式，可以在中央管理存放區升級期間備份與還原您的 Lync Server 拓撲、組態設定與原則。Export-CsConfiguration 指令程式可讓您將資料匯出至 .ZIP 檔案﹔然後可以使用 Import-CsConfiguration 指令程式讀取該 .ZIP 檔案，並將拓撲、設定及原則還原至中央管理存放區。接下來，Lync Server 的複寫服務會將還原的資訊複寫到執行服務的電腦。
初始設定位於周邊網路上的電腦時 (例如 Edge Server)，也可以使用匯出與匯入組態資料的功能。設定位於周邊網路上的電腦時，必須先使用 CsConfiguration 指令程式執行手動複寫：您需要使用 Export-CsConfiguration 匯出組態資料，然後將 .ZIP 檔案複製到周邊網路中的電腦。接下來，您可以使用 Import-CsConfiguration 及 LocalStore 參數來匯入資料。您只需要執行一次此動作；之後會自動進行複寫。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Import-CsConfiguration Cmdlet：RTCUniversalServerAdmins。除了必須是 RTCUniversalServerAdmins 的成員以外，您還必須是本機系統管理員或具有本機組態複寫器權限，才能執行這個指令程式。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Import-CsConfiguration"}
參數
| 參數 | 必要 | 類型 | 說明 |
|---|---|---|---|
ByteInput |
選用 |
位元組陣列 |
從以變數儲存的位元組陣列讀取拓撲資訊。此位元組陣列可在呼叫 Export-CsConfiguration 時使用 ByteInput 參數建立。 您無法在同一個命令中同時使用 ByteInput 參數和 FileName 參數。 |
FileName |
選用 |
字串 |
Export-CsConfiguration 建立之 .ZIP 檔案的路徑。例如：-FileName "C:\Config.zip"。請注意，您必須在呼叫 Import-CsConfiguration 時加入 FileName 或 ByteInput 參數，但不可同時加入兩者。 |
Force |
選用 |
切換參數 |
略過執行該命令時，可能出現的任何非嚴重錯誤提示。若要將 Force 參數設為 True，請使用此語法： -Force:$True |
LocalStore |
選用 |
切換參數 |
將組態資料複製到本機電腦，而非複製到中央管理存放區。 |
輸入類型
無。Import-CsConfiguration 不接受管線傳送的輸入。
傳回類型
Import-CsConfiguration 不會傳回任何值或物件。
範例
-------------------------- 範例 1 ------------------------
Import-CsConfiguration -FileName "C:\Config.zip"
以上的命令會從名稱為 C:\Config.zip 的檔案將目前的拓撲、組態設定及原則匯入到中央管理存放區。
-------------------------- 範例 2 ------------------------
Import-CsConfiguration -FileName "C:\Config.zip" -LocalStore
範例 2 顯示一開始時如何將資料複寫到位於周邊網路上的電腦。在此範例中，組態資料已匯出到名稱為 Config.zip 的檔案；此檔案已複製到位於周邊網路上該部電腦上的 C:\ 資料夾。接著使用 Import-CsConfiguration 匯入該資料，並加上 LocalStore 參數，讓資料匯入到本機電腦，而非中央管理存放區。
-------------------------- 範例 3 ------------------------
$x = Export-CsConfiguration -AsBytes
Import-CsConfiguration -ByteInput $x -LocalStore
範例 3 所示的兩個命令會匯出目前的拓撲、組態設定及原則，然後將該資料匯入到本機電腦，全都不需要使用 .ZIP 檔案。為達成此目的，第一個命令使用 Export-CsConfiguration 和 AsBytes 參數，將目前的拓撲、組態設定及原則匯出為位元組陣列；此位元組陣列會以名稱為 $x 的變數儲存。在第二個命令中，會使用 Import-CsConfiguration 和 ByteInput 參數來匯入儲存在 $x 的資訊。LocalStore 參數會讓資料匯入到本機電腦，而非中央管理存放區。最終效果是資料從中央管理存放區複製到本機電腦。