Import-CsLisConfiguration
上次修改主題的時間： 2012-03-23
從備份檔案匯入 Enterprise Voice Enhanced 9-1-1 (E9-1-1) 組態。
語法
Import-CsLisConfiguration -FileName <String>
Import-CsLisConfiguration -ByteInput <Byte[]>
詳細描述
視組織規模的不同，在組織中實作 E9-1-1 會涉及將數千個子網路、連接埠、交換器以及無線存取點與位置進行對應。E9-1-1 組態也包含 E9-1-1 網路路由供應商提供的位置資訊伺服器 (LIS) 相關資訊，和位置、市街地址以及它們是否已經驗證的相關資訊。實作 E9-1-1 需要大量的資訊與設定，強烈建議您定期備份整個組態。您可以呼叫 Export-CsLisConfiguration 指令程式將整個 E9-1-1 組態備份到檔案。呼叫 Import-CsLisConfiguration 會從該檔案還原組態。
透過呼叫此指令程式來還原組態，並不會覆寫現有的組態。它會插入已移除的資訊，但不會移除在備份檔案建立後才新增的現有記錄。
重要：因為從備份中匯入並不會取代現有的記錄，任何已變更的記錄均將還原，而您可能只剩孤立的位置。例如，假設您已定義一個 Location 值為 Building30/Room10 的無線存取點 (WAP)。您應呼叫 Export-CsLisConfiguration 備份您的組態。之後，您將無線存取點的 Location 屬性修改成 Building30/Rooms20-40。如果您接著呼叫 Import-CsLisConfiguration 來還原備份的組態，該 WAP 的位置會是 Building30/Room10 (備份前的位置)，但 Building30/Rooms20-40 的位置仍然存在於位置組態資料庫中。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Import-CsLisConfiguration Cmdlet：RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Import-CsLisConfiguration"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
ByteInput |
必要 |
位元組[] |
傳遞到此參數的值是包含 LIS 組態位元組陣列的變數，此陣列是由 Export-CsLisConfiguration 指令程式加上 AsBytes 參數所建立的。 |
FileName |
必要 |
字串 |
表示您要從備份檔匯入組態時，該備份檔的名稱。您無法指定 FileName 與 ByteInput。每次呼叫此指令程式都只能夠與這兩個參數的其中一個搭配使用。 |
輸入類型
Byte[]。接受來自匯出的 LIS 組態的位元組陣列。位元組陣列必須以單一記錄傳送。請參閱範例 3。
傳回類型
這個指令程式不會傳回值。
範例
-------------------------- 範例 1 --------------------------
Import-CsLisConfiguration -FileName C:\E911Config.bak
此範例從名稱為 E911Config.back 的備份檔案將 E9-1-1 組態匯入至位置組態資料庫。
-------------------------- 範例 2 --------------------------
$lisconfig = Export-CsLisConfiguration -AsBytes
Import-CsLisConfiguration -ByteInput $lisconfig
範例 2 示範如何使用 Import-CsLisConfiguration 指令程式的 ByteInput 參數。第 1 行所示為呼叫 Export-CsLisConfiguration 指令程式加上 AsBytes 參數。此命令的輸出為包含 LIS 組態的位元組陣列。系統會將此陣列指派給 $lisconfig 變數。第二行會呼叫 Import-CsLisConfiguration 指令程式。ByteInput 參數會收到 $lisconfig 的值，此值是包含我們所匯出位元組陣列的變數。這會將該位元組陣列匯回位置組態。
-------------------------- 範例 3 --------------------------
$lisconfig = Export-CsLisConfiguration -AsBytes
$listconfig | Set-Content -Path C:\E911Config.bak -Encoding byte
Get-Content -ReadCount 0 -Encoding byte -Path C:\E911Config.bak | Import-CsLisConfiguration
範例 3 是範例 2 的更完整版，第一行相同，我們呼叫 Export-CsLisConfiguration 與 AsBytes 參數，將 LIS 組態還原成為 $lisconfig 變數中的位元組陣列。此範例剩下的部分則顯示如何將該組態儲存到檔案中，再將組態匯回位置組態資料庫。
在第 2 行中，我們將 $lisconfig 的內容 (此內容是代表 LIS 組態的位元組陣列) 傳送到 Windows PowerShellSet-Content 指令程式。將值指派給 Set-Content 的兩個參數：Path 與 Encoding。指派要儲存組態之 Path 參數的檔案完整路徑和檔案名稱。我們使用 Encoding 參數與位元組的值來確保組態會儲存為位元組陣列。
最後，在第三行會將組態匯回至位置組態資料庫。首先要呼叫 Get-Content 從檔案擷取內容。將 0 值傳遞到 ReadCount 屬性，這會告訴 Get-Content 一次讀取該檔案的所有內容，而非一次讀取一行。再次使用 Encoding 參數與位元組的值來指定我們要從檔案中讀取哪一類型的資料。最後將檔案名稱傳遞到 Path 參數。我們使用 Get-Content 所讀取的檔案內容會傳送到 Import-CsLisConfiguration 指令程式，此指令程式會將儲存的組態匯入到位置資料庫。