Set-CsLisLocation

구문

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에서 위치는 특정 위치에 대한 호출자의 포트, 서브넷, 스위치 또는 무선 액세스 지점 매핑을 기반으로 확인됩니다. 이 맵을 wiremap이라고 합니다. 이 cmdlet은 LIS(위치 정보 서버)의 위치 구성 데이터베이스에 저장된 위치 목록에 있는 기존 주소를 수정하거나 새 주소를 추가합니다. 이후 이 위치는 회사와 연결된 응급 서비스 공급자가 제공하는 유효한 주소 목록과 대조됩니다.

이 cmdlet에 대한 모든 필수 매개 변수의 조합(Instance 제외)은 고유한 항목을 구성합니다. 이러한 매개 변수 중 하나라도 변경되면 기존 위치가 수정되지 않고 새 위치가 만들어집니다. 이러한 매개 변수는 모두 필수 항목이지만 일부는 null 값을 포함할 수 있습니다. null이 아닌 값을 포함해야 하는 매개 변수는 Location, HouseNumber, StreetName, City, State 및 Country입니다. 기존 값을 수정하려면 Instance 매개 변수를 사용하거나 인스턴스를 cmdlet에 파이프해야 합니다.

이 cmdlet을 사용하여 위치를 만드는 것 외에 포트, 서브넷, 스위치 또는 무선 액세스 지점 정보에 대해 새 주소를 입력하는 경우에도 위치가 자동으로 만들어집니다. 이 정보는 Set-CsLisPort, Set-CsLisSubnet, Set-CsLisSwitch 및 Set-CsLisWirelessAccessPoint cmdlet을 사용하여 입력할 수 있습니다.

이 cmdlet을 실행할 수 있는 사용자: 기본적으로 RTCUniversalServerAdmins 그룹의 구성원은 Set-CsLisLocation cmdlet을 로컬로 실행할 수 있습니다. 사용자가 직접 만든 사용자 지정 RBAC(역할 기반 액세스 제어) 역할을 포함하여 이 cmdlet이 할당된 모든 RBAC 역할의 목록을 가져오려면 Windows PowerShell 프롬프트에서 다음 명령을 실행합니다.

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsLisLocation"}

매개 변수

입력 형식

LIS 위치 개체의 파이프라인된 입력을 허용합니다.

반환 형식

이 cmdlet은 값 또는 개체를 반환하지 않습니다. 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입니다. 이 주소는 HouseNumber 매개 변수 값으로 1000, StreetName 매개 변수 값으로 Main, City 매개 변수 값으로 Redmond, 그리고 Country 매개 변수 값으로 US를 지정하여 입력됩니다.

여기 나온 매개 변수를 사용하여 명령을 실행할 경우 추가 매개 변수를 입력하라는 메시지가 표시됩니다. 그러나 그냥 각 메시지에서 값을 지정하지 않고 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과 비슷합니다. 그러나 이 예제에서는 cmdlet에 대한 모든 매개 변수를 지정합니다. 이 예제에서는 비워 두려는 모든 값을 빈 문자열로 설정하므로 예제 1의 명령을 실행할 경우 표시되는 메시지가 표시되지 않습니다.

-------------------------- 예제 3 --------------------------

$a = Get-CsLisLocation | Where-Object {$_.Location -ceq "Bldg30NEWing"}
Set-CsLisLocation -Instance $a -StreetSuffix Street

이 예제에서는 예제 1에서 만든 위치를 수정합니다. 이 예제의 첫 번째 줄에서는 먼저 Get-CsLisLocation cmdlet을 호출합니다. 이렇게 하면 Lync Server 2010 배포 내에 정의된 모든 위치가 반환됩니다. 이 컬렉션은 Where-Object cmdlet에 파이프됩니다. Where-Object는 컬렉션에서 Location 속성이 Bldg30NEWing과 같은(-ceq, 대/소문자를 구별하여 동일함) 모든 항목을 검색합니다. 이 조건을 대조하는 개체는 변수 $a에 할당됩니다.

두 번째 줄에서는 Set-CsLisLocation을 호출합니다. 첫 번째 매개 변수는 Instance 매개 변수입니다. 이 매개 변수에 첫 번째 줄에서 검색한 개체가 포함된 변수($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을 호출하여 모든 위치를 검색합니다. Location 속성이 NorthCampus와 같은 위치만 포함하는 컬렉션으로 범위를 좁히는 Where-Object로 이 위치 컬렉션을 파이프합니다. 이 새 컬렉션은 변수 $a에 저장됩니다. 두 번째 줄에서 $a의 내용을 Set-CsLisLocation cmdlet에 파이프합니다. 이 cmdlet은 $a에 저장된 각 개체(각 위치)를 거치면서 해당 개체를 수정합니다. 이 경우 수정은 각 개체의 StreetSuffix 속성을 Avenue로 변경하는 것입니다.

이 예제의 명령은 변수를 사용하지 않고도 수행할 수 있습니다. 다음과 같이 Where-Object 명령의 결과를 Set-CsLisLocation 명령에 파이프하기만 하면 됩니다.

Get-CsLisLocation | Where-Object {$_.Location -ceq "NorthCampus"} | Set-CsLisLocation -StreetSuffix Avenue

참고 항목

기타 리소스

Remove-CsLisLocation
Get-CsLisLocation
Set-CsLisPort
Set-CsLisSubnet
Set-CsLisSwitch
Set-CsLisWirelessAccessPoint
Get-CsLisCivicAddress