Set-CsLisWirelessAccessPoint
上次修改主題的時間： 2012-03-24
建立位置資訊伺服器 (LIS) 無線存取點 (WAP)、建立 WAP 與位置 (如果該位置不存在，則建立一個新位置) 之間的關聯性，或修改現有 WAP 及其相關聯的位置。WAP 與位置之間的關聯性在增強型 9-1-1 (E9-1-1) Enterprise Voice 實作中，用於通知緊急服務接線生來電者的位置。
語法
Set-CsLisWirelessAccessPoint -BSSID <String> [-City <String>] [-CompanyName <String>] [-Confirm [<SwitchParameter>]] [-Country <String>] [-Description <String>] [-HouseNumber <String>] [-HouseNumberSuffix <String>] [-Location <String>] [-PostalCode <String>] [-PostDirectional <String>] [-PreDirectional <String>] [-State <String>] [-StreetName <String>] [-StreetSuffix <String>] [-WhatIf [<SwitchParameter>]]
Set-CsLisWirelessAccessPoint -BSSID <String> [-Confirm [<SwitchParameter>]] [-Description <String>] [-WhatIf [<SwitchParameter>]]
Set-CsLisWirelessAccessPoint -City <String> -CompanyName <String> -Country <String> -HouseNumber <String> -HouseNumberSuffix <String> -Location <String> -PostalCode <String> -PostDirectional <String> -PreDirectional <String> -State <String> -StreetName <String> -StreetSuffix <String> [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]]
詳細描述
增強型 9-1-1 讓緊急電話接線員不必詢問來電者的位置資訊，就能找出來電者的位置。當來電者是從 Voice over Internet Protocol (VoIP) 連線撥話時，必須根據各種連線係數來擷取該資訊。VoIP 系統管理員必須設定可判斷來電者位置的位置圖 (稱為線路圖)。這個指令程式可讓系統管理員將實際位置對應到路由傳送來電所使用的 WAP。
BSSID 參數是此指令程式的唯一必要參數。如果您輸入已經存在的 BSSID 值，這個指令程式將會根據所提供的位置參數更新該 WAP 的位置。如果 BSSID 不存在，則會建立新的 WAP 位置。
如果其位址與此處輸入之位址參數 (包括 null 值) 完全相符的位置不存在於位置資料庫中，就會根據使用此指令程式輸入的參數建立新的位址 (您可以呼叫 Get-CsLisLocation 指令程式來擷取位置清單)。Set-CsLisWirelessAccessPoint 指令程式不需要也不會提示位置參數，因此您可以建立一個 WAP 項目，而不將該項目與位置產生關聯。您也可以使用這個指令程式建立一個無效的位置。有效的位置至少包含 Location (位置)、HouseNumber (門牌號碼)、StreetName (街道名稱)、City (城市)、State (州) 及 Country (國家/地區)。如果您未提供以上所有參數，則由所參考之 WAP 接聽的來電可能就不包含緊急服務接線生需要的資訊。建議您所使用的位置參數盡可能明確，並填入盡可能多的位置參數。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Set-CsLisWirelessAccessPoint Cmdlet：RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsLisWirelessAccessPoint"}
參數
| 參數 | 必要 | 類型 | 說明 |
|---|---|---|---|
BSSID |
必要 |
字串 |
無線存取點的基礎服務組識別元 (BSSID)。這個值必須採用 nn-nn-nn-nn-nn-nn 的格式，例如 12-34-56-78-90-ab。如果具有指定之 BSSID 值的項目不存在，則會建立新的 WAP 位置。如果具有指定之 BSSID 的項目存在，則會取代該項目。 |
City |
必要 |
字串 |
此位置的城市。 長度上限：64 個字元。 |
CompanyName |
必要 |
字串 |
此位置的公司名稱。 長度上限：60 個字元 |
Country |
必要 |
字串 |
此位置所在國家/地區。 長度上限：2 個字元 |
Description |
選用 |
字串 |
此 WAP 位置的詳細說明。 |
HouseNumber |
必要 |
字串 |
此位置的門牌號碼。以公司而言，此為公司在街道上的號碼。 最大長度：10 個字元 |
HouseNumberSuffix |
必要 |
字串 |
門牌號碼的其他資訊，如 1/2 或 A。例如，1234 1/2 Oak Street 或 1234 A Elm Street。 附註：若要指定公寓號碼或辦公室套房，您必須使用 Location 參數。例如，-Location "Suite 100/Office 150"。 長度上限：5 個字元 |
Location |
必要 |
字串 |
此位置的名稱。這個值通常是比城市地址更明確的位置名稱 (例如辦公室號碼)，但它可以是任何字串值。 長度上限：20 個字元 |
PostalCode |
必要 |
字串 |
與此位置相關聯的郵遞區號。 長度上限：10 個字元 |
PostDirectional |
必要 |
字串 |
街道名稱的方向指定。例如，Main Street NE 或 7th Avenue NW 中的 NE 或 NW。 長度上限：2 個字元 |
PreDirectional |
必要 |
字串 |
在街道名稱之前的街道名稱方向指定。例如 NE 或 NW 代表 NE Main Street 或 NW 7th Avenue。 最大長度：2 個字元 |
State |
必要 |
字串 |
與此位置相關聯的省或市。 長度上限：2 個字元 |
StreetName |
必要 |
字串 |
此位置的街道名稱。 長度上限：60 個字元 |
StreetSuffix |
必要 |
字串 |
街道名稱中指定的街道類型，例如 Street、Avenue 或 Court。 長度上限：10 個字元 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
接受管線傳送的 LIS 無線存取點物件輸入。
傳回類型
此指令程式會建立或修改 System.Management.Automation.PSCustomObject 類型的物件。
範例
-------------------------- 範例 1 --------------------------
Set-CsLisWirelessAccessPoint -BSSID 99-99-99-99-99-99
範例 1 會建立或更新 LIS WAP 位置項目。此範例中的命令只包含一個 (必要) 參數：BSSID。BSSID 的值是 WAP 的 Identifier (使用 MAC 位址的格式)，在此例中為 99-99-99-99-99-99。
請注意，此範例不包含任何位址資訊。您可以在位置資訊伺服器上建立 WAP 項目，而不將該項目與位址產生關聯。不過，透過此 WAP 路由傳送的緊急電話可能不包含供緊急服務接線生識別位置所需的足夠資訊。
重要：如果具有此 BSSID 的 LIS WAP 位置已經存在，將會以此命令中的值取代。也就是說，如果此 WAP 與某個位址 (實體位置) 相關聯，該關聯性會因為沒有在此命令中加入任何位置資訊而不再存在。此位置仍然存在於位置資料庫中，但不會與此 WAP 相關聯。
-------------------------- 範例 2 --------------------------
Set-CsLisWirelessAccessPoint -BSSID 99-99-99-99-99-99 -Location "30/1000" -HouseNumber 1234 -PreDirectional NE -StreetName First -StreetSuffix Avenue -City Redmond -State WA -Country US -PostalCode 99999
範例 2 會透過加入位址資訊來更新在範例 1 中建立的 WAP (這會實際刪除現有的項目，並以此新項目取代)。如果此位址不存在於位置資料庫中，這個指令程式就會建立該位置。