Set-CsLocationPolicy

 

마지막으로 수정된 항목: 2012-03-26

기존 위치 정책을 수정합니다.

구문

Set-CsLocationPolicy [-Identity <XdsIdentity>] [-ConferenceMode <Nullable>] [-ConferenceUri <String>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-EmergencyDialMask <String>] [-EmergencyDialString <String>] [-EnhancedEmergencyServicesEnabled <$true | $false>] [-Force <SwitchParameter>] [-LocationRequired <Nullable>] [-NotificationUri <String>] [-PstnUsage <String>] [-UseLocationForE911Only <Nullable>] [-WhatIf [<SwitchParameter>]]

Set-CsLocationPolicy [-ConferenceMode <Nullable>] [-ConferenceUri <String>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-EmergencyDialMask <String>] [-EmergencyDialString <String>] [-EnhancedEmergencyServicesEnabled <$true | $false>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-LocationRequired <Nullable>] [-NotificationUri <String>] [-PstnUsage <String>] [-UseLocationForE911Only <Nullable>] [-WhatIf [<SwitchParameter>]]

자세한 정보

위치 정책은 E9-1-1(Enhanced 9-1-1) 기능 및 클라이언트 위치와 관련된 설정을 적용하는 데 사용되며, 사용자가 E9-1-1을 사용하도록 설정되어 있는지 여부를 확인하고, 설정된 경우 응급 통화에 대한 행동을 결정합니다. 예를 들어 위치 정책을 사용하여 응급 통화 번호(한국의 경우 119)를 정의하고, 회사 보안 부서에 자동으로 알림을 제공할지 여부, 통화를 경로 지정할 방법 등을 지정할 수 있습니다. 이 cmdlet은 기존 위치 정책을 수정합니다.

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

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

매개 변수

매개 변수 필수 유형 설명

Identity

선택

Xds ID

수정할 위치 정책의 고유 식별자입니다. 글로벌 위치 정책을 수정하려면 Global 값을 사용합니다. 사이트 범위에서 만들어진 정책의 경우 이 값은 site:<site name> 형식으로 지정됩니다. 여기서 사이트 이름은 Microsoft Lync Server 2010 배포에 정의된 사이트 이름입니다(예: site:Redmond). 사용자별 범위에서 만들어진 정책의 경우 이 값은 단순히 해당 정책의 이름(예: Reno)입니다.

Instance

선택

위치 정책

위치 정책 개체에 대한 참조입니다. 이 개체의 유형은 Microsoft.Rtc.Management.WritableConfig.Policy.Location.LocationPolicy여야 하며, Get-CsLocationPolicy를 호출하여 검색할 수 있습니다. 이 개체를 검색하고, 메모리에서 속성을 변경한 다음, 개체 참조를 이 매개 변수 값으로 전달하여 해당 위치 정책을 업데이트합니다.

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

선택

문자열

이 위치에 대한 자세한 설명입니다(예: “Building 30, 3rd Floor, NorthEast corner”).

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 클라이언트가 등록된 위치 정보를 검색하여 응급 통화 시 해당 정보를 포함합니다.

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

선택

문자열

이 프로필을 사용하는 클라이언트의 911 통화를 경로 지정하는 데 사용할 음성 경로를 확인하는 데 사용되는 PSTN(공중 전화망) 사용법입니다. 이 사용법과 연결된 경로는 응급 통화에 전용되는 SIP 트렁크를 가리켜야 합니다.

사용법은 글로벌 PSTN 사용법 목록에 이미 있어야 합니다. 사용법 목록을 검색하려면 Get-CsPstnUsage cmdlet을 호출합니다. 새 사용법을 만들려면 Set-CsPstnUsage cmdlet을 호출합니다.

UseLocationForE911Only

선택

부울

Microsoft Lync 2010 클라이언트는 현재 위치를 팀원에게 알리는 등 여러 가지 이유로 위치 정보를 사용할 수 있습니다. 응급 통화에만 위치 정보를 사용할 수 있도록 하려면 이 값을 True로 설정합니다.

Force

선택

스위치 매개 변수

변경 내용을 적용하기 전에 표시될 수 있는 확인 메시지를 숨깁니다.

WhatIf

선택

스위치 매개 변수

명령을 실제로 실행하지 않고도 명령이 실행될 경우 발생할 수 있는 현상을 설명합니다.

Confirm

선택

스위치 매개 변수

명령을 실행하기 전에 확인 메시지를 표시합니다.

입력 형식

Microsoft.Rtc.Management.WritableConfig.Policy.Location.LocationPolicy 개체입니다. 위치 정책 개체의 파이프라인된 입력을 허용합니다.

반환 형식

이 cmdlet은 값이나 개체를 반환하지 않습니다. 대신에 이 cmdlet은 Microsoft.Rtc.Management.WritableConfig.Policy.Location.LocationPolicy 개체의 인스턴스를 구성합니다.

예제

-------------------------- 예제 1 --------------------------

Set-CsLocationPolicy -Identity site:Redmond -EnhancedEmergencyServicesEnabled $True

이 명령은 Set-CsLocationPolicy cmdlet을 사용하여 ID가 site:Redmond인 위치 정책을 수정합니다. 즉, Redmond 사이트에 적용되는 위치 정책을 수정합니다. 이 예제의 명령은 EnhancedEmergencyServicesEnabled 속성 값을 True로 설정하여 Redmond 사이트에 연결된 모든 사용자에 대해 E9-1-1 기능을 사용하도록 설정합니다.

-------------------------- 예제 2 --------------------------

Get-CsLocationPolicy | Where-Object {$_.ConferenceUri -ne $null} | Set-CsLocationPolicy -ConferenceMode twoway

예제 2에서는 조직에서 사용 중인 위치 정책 중 전화 회의 URI를 정의한 모든 위치 정책을 수정하여 전화 회의 모드를 양방향(two-way)으로 설정합니다. 이 작업을 수행하기 위해 명령은 먼저 Get-CsLocationPolicy를 사용하여 현재 정의된 모든 위치 정책의 컬렉션을 반환합니다. 이 컬렉션은 ConferenceUri 속성이 비어 있지 않은(Null과 같지 않은) 위치 정책으로 컬렉션 범위를 좁히는 Where-Object cmdlet에 파이프됩니다. 그러면 ConferenceUri 값이 있는 위치 정책만 컬렉션에 포함됩니다. 이 컬렉션은 값을 twoway로 설정하여 컬렉션의 각 정책에 대한 ConferenceMode 속성 값을 수정하는 Set-CsLocationPolicy에 파이프됩니다.