Set-CsLisLocation
上次修改主題的時間： 2012-03-26
在位置組態資料庫中，針對增強型 9-1-1 (E9-1-1) 建立新位置或修改現有位置。
語法
Set-CsLisLocation -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>]]
Set-CsLisLocation -Instance <PSObject> [-City <String>] [-CompanyName <String>] [-Confirm [<SwitchParameter>]] [-Country <String>] [-HouseNumber <String>] [-HouseNumberSuffix <String>] [-Location <String>] [-PostalCode <String>] [-PostDirectional <String>] [-PreDirectional <String>] [-State <String>] [-StreetName <String>] [-StreetSuffix <String>] [-WhatIf [<SwitchParameter>]]
詳細描述
E9-1-1 可讓接聽緊急電話的人能夠判定來電者的地理位置，而無需向來電者詢問該資訊。Microsoft Lync Server 2010 是根據來電者連接埠、子網路、交換器或無線存取點與特定位置間的對應，來判定來電者的位置。(此對應稱為連線對應。)此指令程式會在位置資訊伺服器 (LIS) 上的位置組態資料庫中所儲存的位置清單中，新增地址或修改現有地址。這些位置後續會對應到與公司合作之緊急服務提供者所提供的有效地址清單。
此指令程式所有必要參數 (Instance 除外) 的組合會構成唯一的項目。變更其中任何參數都將建立新的位置，而不是修改現有的位置。請注意，雖然這些參數全都是必要參數，但是有些參數可能包含 Null 值。必須包含非 Null 值的參數為：Location、HouseNumber、StreetName、City、State 和 Country。若要變更現有值，您必須使用 Instance 參數 (或將執行個體傳送至指令程式)。
除了使用此指令程式建立位置外，針對連接埠、子網路、交換器或無線存取點資訊輸入新地址時，也會自動建立位置。您可以使用 Set-CsLisPort、Set-CsLisSubnet、Set-CsLisSwitch 和 Set-CsLisWirelessAccessPoint 指令程式來輸入此資訊。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Set-CsLisLocation Cmdlet：RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsLisLocation"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Instance |
必要 |
PSObject |
位置物件的參考。此物件必須包含建立位置所需的屬性。您可以呼叫 Get-CsLisLocation 來擷取此類型的物件。 |
City |
必要 |
字串 |
城市位置。 最大長度：64 個字元。 |
CompanyName |
必要 |
字串 |
此位置之公司的名稱。 最大長度：60 個字元 |
Country |
必要 |
字串 |
此位置所在國家/地區。 最大長度：2 個字元 |
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 |
必要 |
字串 |
街道名稱的方向指定。例如 NE 或 NW 代表 Main Street NE 或 7th Avenue NW。 最大長度：2 個字元 |
PreDirectional |
必要 |
字串 |
街道名稱的方向指定放在街道名稱前。例如 NE 或 NW 代表 NE Main Street 或 NW 7th Avenue。 最大長度：2 個字元 |
State |
必要 |
字串 |
與此位置相關聯的州或省。 最大長度：2 個字元 |
StreetName |
必要 |
字串 |
此位置的街道名稱。 最大長度：60 個字元 |
StreetSuffix |
必要 |
字串 |
在街道名稱中指定的街道類型，例如街、道或巷。 最大長度：10 個字元 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
接受管線傳送的 LIS 位置物件輸入。
傳回類型
這個指令程式不會傳回值或物件。它會建立或修改 System.Management.Automation.PSCustomObject 類型的物件。
範例
-------------------------- 範例 1 --------------------------
Set-CsLisLocation -Location Bldg30NEWing -HouseNumber 1000 -StreetName Main -City Redmond -State WA -Country US
範例 1 會建立名為 Bldg30NEWing 的新位置。此命令會填寫所有必要參數，以便有值可用來建立位置。在此範例中，位置的地址為 1000 Main, Redmond, WA, US。輸入該地址的方法為以值 1000 指定 HouseNumber 參數、以值 Main 指定 StreetName 參數、以值 Redmond 指定 City 參數，並以值 US 指定 Country 參數。
請注意，如果您以這裡顯示的參數執行命令，系統將提示您輸入更多參數。但即使您在每個提示出現時直接按 Enter 鍵而不提供值，也會建立位置。
-------------------------- 範例 2 --------------------------
Set-CsLisLocation -Location "Suite 100/Office 20" -CompanyName "Litware, Inc." -HouseNumber 1234 -HouseNumberSuffix "" -PreDirectional "" -StreetName Main -StreetSuffix St -PostDirectional "" -City Redmond -State WA -PostalCode 99999 -Country US
此範例和範例 1 一樣會建立新的位置。然而，此範例中的命令會指定指令程式的所有參數。這樣將可避免出現範例 1 的命令所引起的提示，因為此範例會直接將任何我們想要留空的值設定成空字串。
-------------------------- 範例 3 --------------------------
$a = Get-CsLisLocation | Where-Object {$_.Location -ceq "Bldg30NEWing"}
Set-CsLisLocation -Instance $a -StreetSuffix Street
此範例會修改範例 1 中建立的位置。範例中的第一行以呼叫 Get-CsLisLocation 指令程式作為開始。這會傳回 Lync Server 2010 部署內所有已定義之位置的集合。此集合會被傳送到 Where-Object 指令程式。Where-Object 會從集合中擷取所有其 Location 屬性等於 (-ceq，區分大小寫的等於) Bldg30NEWing 的項目。符合此準則的物件會指派給變數 $a。
在第 2 行，我們呼叫 Set-CsLisLocation。第一個參數為 Instance 參數。我們將含有第 1 行擷取之物件的變數 ($a) 傳給此參數，此物件正好是我們想要修改的物件。然後，我們指定 StreetSuffix 參數並傳遞 Street 值給它。這會將變數 $a 中位置的 StreetSuffix 屬性值變更為 Street。
請注意，因為 Location 不是唯一屬性，所以 Where-Object Cmdlet 可能會傳回多個位置。若是如此，此範例將無法運作。若要一次修改多個位置，請參閱範例 4。
-------------------------- 範例 4 --------------------------
$a = Get-CsLisLocation | Where-Object {$_.Location -ceq "NorthCampus"}
$a | Set-CsLisLocation -StreetSuffix Avenue
範例 4 會修改一或多個位置物件的 StreetSuffix 屬性。此範例的開頭很像範例 3。我們以呼叫 Get-CsLisLocation 來擷取所有位置作為開始。接著，將此位置集合傳送至 Where-Object，以將集合縮小到只有 Location 屬性等於 NorthCampus 的位置。此新的集合會儲存於變數 $a 中。在第 2 行，我們將 $a 的內容傳送至 Set-CsLisLocation 指令程式。此指令程式會逐一處理 $a 中所儲存的每個物件 (每個位置)，並修改該物件。此處所指的修改是將每個物件的 StreetSuffix 屬性都變更為 Avenue。
此範例中的命令不使用變數也能完成。只需將 Where-Object 命令的結果傳送至 Set-CsLisLocation 命令即可，如下所示：
Get-CsLisLocation | Where-Object {$_.Location -ceq "NorthCampus"} | Set-CsLisLocation -StreetSuffix Avenue