New-CsLocationPolicy
마지막으로 수정된 항목: 2012-03-26
E9-1-1(Enhanced 9-1-1) 서비스 및 일반 클라이언트 위치에 대한 위치 식별에 사용할 새 위치 정책을 만듭니다. E9-1-1 서비스를 사용하면 911 전화 응답자가 발신자의 지리적 위치를 확인할 수 있습니다.
구문
New-CsLocationPolicy -Identity <XdsIdentity> [-ConferenceMode <Nullable>] [-ConferenceUri <String>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-EmergencyDialMask <String>] [-EmergencyDialString <String>] [-EnhancedEmergencyServicesEnabled <$true | $false>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-LocationRequired <Nullable>] [-NotificationUri <String>] [-PstnUsage <String>] [-UseLocationForE911Only <Nullable>] [-WhatIf [<SwitchParameter>]]
자세한 정보
위치 정책은 E9-1-1 기능과 관련된 설정 및 위치 설정을 사용자 또는 연락처에 적용하는 데 사용됩니다. 사용자가 E9-1-1을 사용하도록 설정되어 있는지 여부를 확인하고, 설정된 경우 응급 통화에 대한 행동을 결정합니다. 예를 들어 위치 정책을 사용하여 응급 통화 번호(한국의 경우 119)를 정의하고, 회사 보안 부서에 자동으로 알림을 제공할지 여부, 통화를 경로 지정할 방법 등을 지정할 수 있습니다. 이 cmdlet은 사이트 범위 또는 사용자별 범위에 새 위치 정책을 만듭니다. 글로벌 범위의 정책은 이미 있습니다.
중요: 위치 정책은 범위 체계와 관련하여 Lync Server 2010의 다른 정책과 다르게 동작합니다. 다른 모든 정책의 경우 정책이 사용자별 범위에 정의되어 있으면 해당 정책이 부여된 모든 사용자에게 정책이 적용됩니다. 사용자에게 사용자별 정책이 부여되지 않았으면 사이트 정책이 적용됩니다. 사이트 정책이 없으면 글로벌 정책이 적용됩니다. 위치 정책도 동일한 방식으로 적용됩니다. 단, 한 가지 예외는 네트워크 사이트에 사용자별 위치 정책을 할당할 수도 있다는 점입니다. 네트워크 사이트는 서브넷 그룹으로 구성됩니다. 사용자가 조직 내 네트워크 사이트에 매핑된 위치에서 응급 통화를 걸면 해당 네트워크에 할당된 사용자 수준 정책이 사용됩니다. 이 기능은 해당 사용자에게 부여된 사용자별 정책보다 우선합니다. 사용자가 조직에서 알 수 없거나 매핑되지 않은 위치에서 전화를 거는 경우 표준 정책 범위가 적용됩니다.
이 cmdlet을 실행할 수 있는 사용자: 기본적으로 RTCUniversalServerAdmins 그룹의 구성원은 New-CsLocationPolicy cmdlet을 로컬로 실행할 수 있습니다. 사용자가 직접 만든 사용자 지정 RBAC(역할 기반 액세스 제어) 역할을 포함하여 이 cmdlet이 할당된 모든 RBAC 역할의 목록을 가져오려면 Windows PowerShell 프롬프트에서 다음 명령을 실행합니다.
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsLocationPolicy"}
매개 변수
| 매개 변수 | 필수 | 유형 | 설명 |
|---|---|---|---|
Identity |
선택 |
Xds ID |
위치 정책에 대한 고유 식별자입니다. 이 cmdlet은 사이트 범위 또는 사용자별 범위에 정책을 만드는 데 사용할 수 있습니다. 글로벌 정책은 기본적으로 존재하며 제거할 수 없습니다. 사이트 범위에 정책을 만드는 경우 이 값은 site:<site name> 형식이어야 하며 여기서 site name은 Microsoft Lync Server 2010 배포에서 정의된 사이트의 이름입니다(예: site:Redmond). 사용자별 범위에 만든 정책에는 Reno와 같은 모든 문자열 값을 할당할 수 있습니다. |
ConferenceMode |
선택 |
전화 회의 모드 열거 |
ConferenceUri 매개 변수 값을 지정하면 ConferenceMode 매개 변수에서 제3자가 통화에 참가할 수 있는지 또는 들을 수만 있는지를 결정합니다. 사용할 수 있는 값은 다음과 같습니다. - oneway: 제3자가 발신자와 PSAP(Public Safety Answering Point) 교환원 사이의 대화를 들을 수만 있습니다. - twoway: 제3자가 발신자와 PSAP 교환원의 통화 내용을 듣고 통화에 참여할 수 있습니다. |
ConferenceUri |
선택 |
문자열 |
걸려 온 응급 통화에 함께 응답할 제3자의 SIP URI(Uniform Resource Identifier)(이 경우 전화 번호)입니다. 예를 들어 누군가 응급 통화를 걸면 회사의 경비실에서 전화를 받고 해당 통화의 내용을 듣거나 통화에 참여할 수 있습니다(ConferenceMode 속성 값에 따라 다름). 이 문자열은 1자에서 256자 사이여야 하며 접두사 sip:로 시작해야 합니다. |
Description |
선택 |
문자열 |
이 위치에 대한 자세한 설명입니다(예: “Reno corporate users”). |
EmergencyDialMask |
선택 |
문자열 |
사용자가 전화를 걸면 EmergencyDialString 속성 값으로 변환되는 번호입니다. 예를 들어 EmergencyDialMask 값이 "212"이고 EmergencyDialString 값이 "911"인 경우, 사용자가 212로 전화를 걸면 911로 전화가 연결됩니다. 이 매개 변수를 지정하면 대체 응급 번호를 사용하여 응급 서비스에 전화를 걸 수 있습니다. 예를 들어 응급 번호가 다른 국가의 사용자가 외국에서 그 나라의 번호 대신 자신의 국가에서 사용되는 번호로 전화를 거는 경우에 유용합니다. 값을 세미콜론으로 구분하여 여러 응급 다이얼 마스크를 정의할 수 있습니다(예: -EmergencyDialMask "212;414"). 중요. 지정된 다이얼 마스크 값은 통화 대기 궤도 범위의 번호와 달라야 합니다. 통화 대기 경로 지정은 응급 다이얼 문자열 변환보다 우선합니다. 기존 통화 대기 궤도 범위를 보려면 Get-CsCallParkOrbit cmdlet을 호출합니다. 문자열의 최대 길이는 100자입니다. 각 문자는 0부터 9까지의 숫자여야 합니다. |
EmergencyDialString |
선택 |
문자열 |
응급 서비스에 연결되는 전화 번호입니다. 미국의 경우 이 값은 911입니다. 이 문자열은 0에서 9 사이의 숫자로 구성되어야 하며 1자에서 10자 사이일 수 있습니다. |
EnhancedEmergencyServicesEnabled |
필수 |
부울 |
이 정책과 연결된 사용자가 E9-1-1을 사용할 수 있는지 여부를 지정합니다. E9-1-1을 사용하도록 설정하려면 값을 True로 설정합니다. 그러면 Lync Server 2010 클라이언트가 등록된 위치 정보를 검색하여 응급 통화 시 해당 정보를 포함합니다. 기본값: False |
LocationRequired |
선택 |
필수 위치 열거 |
클라이언트가 위치 구성 데이터베이스에서 위치를 검색할 수 없는 경우 사용자에게 위치를 수동으로 입력하라는 메시지를 표시하는 데 사용됩니다. 이 매개 변수에는 다음 값이 허용됩니다. - no: 사용자에게 위치를 묻는 메시지가 표시되지 않습니다. 위치 정보가 없는 상태에서 전화를 걸면 응급 서비스 공급자가 전화를 받은 후 위치를 물어봅니다. - yes: 클라이언트가 새 위치에서 등록하면 사용자에게 위치 정보를 입력하라는 메시지가 표시됩니다. 사용자는 정보를 입력하지 않은 상태로 메시지를 취소할 수 있습니다. 정보를 입력하면 911 통화 시 PSAP 교환원(911 교환원)으로 경로 지정되기 전에 먼저 응급 서비스 공급자가 응답하여 위치를 확인합니다. - disclaimer: 이 옵션은 yes와 같지만 사용자가 메시지를 취소하는 경우 사용자에게 위치 정보 입력 거부에 대한 결과를 알려 주는 고지 사항 텍스트가 표시됩니다. 이 고지 사항 텍스트는 Set-CsEnhancedEmergencyServiceDisclaimer cmdlet을 호출하여 설정해야 합니다. EnhancedEmergencyServicesEnabled가 False(기본값)로 설정된 경우 이 값은 무시됩니다. 사용자에게 위치 정보를 묻는 메시지가 표시되지 않습니다. |
NotificationUri |
선택 |
문자열 |
응급 통화가 걸려 올 때 알림을 받을 하나 이상의 SIP URI입니다. 예를 들어 회사의 보안 부서에서 응급 통화가 걸려 올 때마다 인스턴트 메시지를 통해 알림을 받을 수 있습니다. 발신자의 위치를 파악할 수 있는 경우 해당 위치가 알림에 포함됩니다. 쉼표로 구분된 목록으로 여러 SIP URI를 포함할 수 있습니다. 예를 들어 -NotificationUri sip:security@litwareinc.com,sip:kmyer@litwareinc.com과 같은 형식으로 포함됩니다. 메일 그룹 URI는 지원되지 않습니다. 이 문자열은 1자에서 256자 사이여야 하며 접두사 sip:로 시작해야 합니다. |
PstnUsage |
선택 |
문자열 |
이 프로필을 사용하는 클라이언트의 응급 통화를 경로 지정하는 데 사용할 음성 경로를 확인하는 데 사용되는 PSTN(공중 전화망) 사용법입니다. 이 사용법과 연결된 경로는 응급 통화에 전용되는 SIP 트렁크를 가리켜야 합니다. 사용법은 글로벌 PSTN 사용법 목록에 이미 있어야 합니다. 사용법 목록을 검색하려면 Get-CsPstnUsage cmdlet을 호출합니다. 새 사용법을 만들려면 Set-CsPstnUsage cmdlet을 호출합니다. |
UseLocationForE911Only |
선택 |
부울 |
Microsoft Lync 2010 클라이언트는 현재 위치를 팀원에게 알리는 등 여러 가지 이유로 위치 정보를 사용할 수 있습니다. 응급 통화에만 위치 정보를 사용할 수 있도록 하려면 이 값을 True로 설정합니다. |
Force |
선택 |
스위치 매개 변수 |
변경하기 전에 표시되는 확인 메시지를 표시하지 않습니다. |
InMemory |
선택 |
스위치 매개 변수 |
개체를 실제로 영구 변경 사항으로 커밋하지 않고 개체 참조를 만듭니다. 이 매개 변수와 함께 호출된 이 cmdlet의 결과를 변수로 할당하면 개체 참조의 속성을 변경한 후 이 cmdlet과 일치하는 Set- cmdlet을 호출하여 해당 변경 사항을 커밋할 수 있습니다. |
WhatIf |
선택 |
스위치 매개 변수 |
명령을 실제로 실행하지 않고도 명령이 실행될 경우 발생할 수 있는 현상을 설명합니다. |
Confirm |
선택 |
스위치 매개 변수 |
명령을 실행하기 전에 확인 메시지를 표시합니다. |
입력 형식
없음.
반환 형식
Microsoft.Rtc.Management.WritableConfig.Policy.Location.LocationPolicy 유형의 개체를 만듭니다.
예제
-------------------------- 예제 1 --------------------------
New-CsLocationPolicy -Identity site:Redmond -EnhancedEmergencyServicesEnabled $True
예제 1은 New-CsLocationPolicy를 사용하여 레드몬드 사이트의 모든 사용자가 E9-1-1을 사용할 수 있도록 설정하는 새 위치 정책을 만듭니다. 이 정책을 만들려면 New-CsLocationPolicy를 호출합니다. 이때 Identity를 설정할 매개 변수 하나를 먼저 지정합니다. 이 경우에는 문자열 site: 다음에 이 정책을 적용할 사이트의 이름을 지정합니다. 그런 다음 EnhancedEmergencyServicesEnabled 속성 값을 True로 설정하는 매개 변수를 지정합니다.
-------------------------- 예제 2 --------------------------
New-CsLocationPolicy -Identity Reno -Description "All users located at the Reno site" -EnhancedEmergencyServicesEnabled $True -PstnUsage Emergency -EmergencyDialString 911
이 예제는 사용자별 위치 정책을 만듭니다. 사용자별 정책은 개별 사용자 또는 그룹에게 개별적으로 부여되어야 합니다. 이 정책에는 Reno의 Identity가 있습니다. Description 매개 변수를 사용하여 정책에 대한 자세한 설명을 추가했습니다. 다음으로 지정한 매개 변수는 EnhancedEmergencyServicesEnabled이며 이 정책을 부여할 모든 사용자가 E9-1-1 기능을 사용할 수 있도록 True로 설정되어 있습니다. 다음 매개 변수는 PstnUsage이며 이 경우 값은 Emergency입니다. 이 값은 PSTN 사용 목록의 값과 일치해야 합니다. 이 목록은 Get-CsPstnUsage를 호출하여 검색할 수 있습니다. 사용은 응급 통화에 사용할 음성 경로에 연결해야 합니다. Get-CsVoiceRoute cmdlet을 호출하여 음성 경로를 검색할 수 있습니다. 이 예제에 사용된 마지막 매개 변수 EmergencyDialString은 응급 통화로 연결할 번호를 지정합니다.