Set-CsLocationPolicy

Skype for Business Server 2015
 

Дата изменения раздела:2017-03-28

Изменяет существующую политику определения местонахождения. Данный командлет впервые появился в Lync Server 2010.

Set-CsLocationPolicy [-Identity <XdsIdentity>] <COMMON PARAMETERS>
Set-CsLocationPolicy [-Instance <PSObject>] <COMMON PARAMETERS>
COMMON PARAMETERS: [-ConferenceMode <oneway | twoway>] [-ConferenceUri <String>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-EmergencyDialMask <String>] [-EmergencyDialString <String>] [-EnhancedEmergencyServiceDisclaimer <String>] [-EnhancedEmergencyServicesEnabled <$true | $false>] [-Force <SwitchParameter>] [-LocationRefreshInterval <Int64>] [-LocationRequired <yes | no | disclaimer>] [-NotificationUri <String>] [-PstnUsage <String>] [-Tenant <Guid>] [-UseLocationForE911Only <$true | $false>] [-WhatIf [<SwitchParameter>]]

Эта команда использует командлет Set-CsLocationPolicy для изменения политики определения местоположения с удостоверением "Identity site:Redmond". (Другими словами, он изменяет политику определения местоположения, применяемую к сайту Redmond). В этом случае команда задает значение True для свойства EnhancedEmergencyServicesEnabled, что активирует функцию E9-1-1 для всех пользователей, подключенных к (в данном случае) сайту Redmond.

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

В примере 2 выполняется изменение всех политик определения местоположения, используемых в организации, которые определяют универсальный код ресурса конференц-связи для создания конференций в двухстороннем режиме. При выполнении этой задачи команда сначала использует командлет Get-CsLocationPolicy для возврата набора всех заданных в настоящий момент политик определения местоположения. Этот набор затем передается в командлет Where-Object для возврата уменьшенного набора, включающего только те политики определения местоположения, значение свойства ConferenceUri для которых не является пустым (нулевым). Это приводит к созданию набора политики определения местоположения, для которых назначены значения ConferenceUri. Этот набор затем передается в командлет Set-CsLocationPolicy , который изменяет значение свойства ConferenceMode для каждой политики в наборе и задает для них значение "twoway".

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

Политика определения местоположения используется для применения параметров, связанных с расширенной функцией 911 (E9-1-1) и местоположением клиента. Политика определения местоположения определяет, активирована ли для пользователя функция E9-1-1 и, если да, то в каком режиме выполняются экстренные вызовы. Например, можно использовать политику определения местоположения, чтобы определить, какой номер должен использоваться для экстренных вызовов (911 в Соединенных Штатах), следует ли автоматически уведомлять службу корпоративной безопасности и каким образом должна осуществляться маршрутизация вызова. Этот командлет изменяет существующую политику определения местоположения.

По умолчанию право на локальный запуск командлета Set-CsLocationPolicy имеют члены группы RTCUniversalServerAdmins. Чтобы получить список всех ролей управления доступом на основе ролей (RBAC), которым назначен этот командлет (включая все самостоятельно созданные роли RBAC), выполните в командной строке Windows PowerShell следующую команду:

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

 

Параметр Обязательный? Тип Описание

ConferenceMode

Необязательный

Microsoft.Rtc.Management.WritableConfig.Policy.Location.ConferenceModeEnum

Если для параметра ConferenceUri указано какое-либо значение, параметр ConferenceMode определяет, могут ли третьи лица принимать участие в вызове или они могут выступать только в качестве слушателей. Доступные значения:

Oneway — третьи лица могут только прослушивать беседу между абонентом и оператором Public Safety Answering Point (PSAP).

Twoway — третьи лица могут прослушивать беседу между абонентом и оператором PSAP и участвовать в ней.

ConferenceUri

Необязательный

System.String

Универсальный код ресурса (URI) SIP (в данном случае номер телефона) третьего лица, которое будет принимать участие в любых выполняемых экстренных конференц-вызовах. Например, представитель службы безопасности компании может принимать звонок при выполнении экстренного вызова и прослушивать беседу или принимать в ней участие (в зависимости от значения свойства ConferenceMode).

Длина строки должна быть в пределах от 1 до 256 символов, строка должна начинаться с префикса "sip:".

Confirm

Необязательный

System.Management.Automation.SwitchParameter

Запрашивает подтверждение перед выполнением команды.

Description

Необязательный

System.String

Подробное описание этого местоположения. Пример: "Строение 3, 3-й этаж, северо-восточный угол".

EmergencyDialMask

Необязательный

System.String

Набираемый номер затем преобразуется в значение свойства EmergencyDialString. Например, если для EmergencyDialMask установлено значение "212" и для EmergencyDialString установлено значение "911", при наборе пользователем номера 212 осуществляется вызов по линии 911. Это позволяет набирать альтернативные номера служб экстренной помощи и связываться с сотрудникам аварийно-спасательных служб (например, если человек находится в другой стране/регионе, где используются иные номера служб экстренной помощи, и он пытается набрать номер для данной страны или региона, а не для той страны и не для того региона, где он находится в настоящее время). Можно задать несколько масок набора номеров служб экстренной помощи, разделяя значения точкой с запятой. Пример: -EmergencyDialMask "212, 414".

ВАЖНО. Убедитесь, что указанное значение макси набора не совпадает с номером из диапазона орбиты парковки вызовов. Маршрутизация парковки вызовов имеет приоритет над преобразованием строки набора номера экстренного вызова. Чтобы отобразить существующие диапазоны орбиты парковки вызовов, вызовите командлет Get-CsCallParkOrbit .

Максимальная длина строки составляет 100 символов. Каждый символ должен быть цифрой от 0 до 9.

EmergencyDialString

Необязательный

System.String

Номер, набираемый для связи с аварийными службами. В Соединенных Штатах используется значение "911".

Строка должна состоять из цифр от 0 до 9; ее длина может составлять от 1 до 10 символов.

EnhancedEmergencyServiceDisclaimer

Необязательный

System.String

Текстовое значение, содержащее информацию, которая будет отображаться для пользователей, подключаемых из тех мест, которые не могут быть определены путем сопоставления местоположений, при условии, что эти пользователи не ввели местоположение вручную. Чтобы удалить отказ службы из политики определения местоположения, задайте нулевое значение для этого свойства:

-EnhancedEmergencyServiceDisclaimer $Null

Чтобы настроить заявления об отказе от ответственности в службе E9-1-1, необходимо использовать политики расположения и свойство EnhancedEmergencyServiceDisclaimer в Skype для бизнеса Server 2015. Используя политики расположения для настройки заявлений об отказе от ответственности, вы можете создавать разные заявления для разных областей действия или разных наборов пользователей.

EnhancedEmergencyServicesEnabled

Необязательный

System.Boolean

Указывает, активирована ли для пользователей, связанных с этой политикой, функция E9-1-1. Установите значение True, чтобы активировать E9-1-1; в результате клиенты Skype для бизнеса Server 2015 будут загружать информацию о местоположении при регистрации и указать эти данные при выполнении экстренного вызова.

Force

Необязательный

System.Management.Automation.SwitchParameter

Подавляет все запросы на подтверждение, которые в противном случае будут отображаться перед применением изменений.

Identity

Необязательный

Microsoft.Rtc.Management.Xds.XdsIdentity

Уникальный идентификатор политики определения местоположения, которую необходимо изменить. Чтобы изменить глобальную политику определения местоположения, используйте значение Global. Для политики, созданной в области сайта, это значение будет иметь вид site:<имя сайта>, где название сайта — это имя сайта, определенное в развертывании Skype для бизнеса Server 2015 (например, site:Redmond). Для политики, созданной на уровне пользователей, это значение представляет собой просто имя политики, например Reno.

Instance

Необязательный

LocationPolicy

Ссылка на объект политики определения местоположения. Этот объект должен иметь тип Microsoft.Rtc.Management.WritableConfig.Policy.Location.LocationPolicy, который можно извлечь путем вызова командлета Get-CsLocationPolicy . Извлеките этот объект, измените свойства в памяти, а затем передайте ссылку на объект в виде значения для данного параметра, чтобы обновить политику определения местоположения.

LocationRefreshInterval

Необязательный

System.Int64

Определяет количество времени (в часах) между клиентскими запросами на обновление местоположения в службе Location Information. Для свойства LocationRefreshInterval можно задать любое значение от 1 до 12; значение по умолчанию — 4.

LocationRequired

Необязательный

Microsoft.Rtc.Management.WritableConfig.Policy.Location.LocationRequiredEnum

Если клиент не смог извлечь местоположение из базы данных конфигурации местоположения, для пользователя отобразится запрос на ввод местоположения вручную. Этот параметр может принимать следующие значения:

- no: для пользователя не будет отображаться запрос на ввод местоположения. При выполнении вызова, для которого отсутствует информация о местоположении, представитель аварийной службы ответит на вызов и попросит сообщить местоположение.

- yes: когда клиент регистрирует новое местоположение, для пользователя отображается запрос на ввод информации о местоположении. Пользователь может отклонить запрос и не вводить никакую информацию. Если пользователь вводит информацию, на вызов по линии 911 сначала отвечает представитель аварийной службы, который уточняет местоположение и переадресует этот вызов PSAP (то есть оператору 911).

- disclaimer: этот вариант аналогичен варианту "yes", но при его выборе в том случае, если пользователь отклоняет запрос, отображается уведомление об отказе, которое предупреждает пользователя о последствиях отказа от ввода информации о местоположении. (Текст отказа можно задать путем вызова командлета Set-CsEnhancedEmergencyServiceDisclaimer .)

Это значение игнорируется, если для параметра EnhancedEmergencyServicesEnabled установлено значение False (по умолчанию). Запрос на ввод информации о местоположении не отображается.

NotificationUri

Необязательный

System.String

Один или несколько универсальных кодов ресурса (URI) SIP для уведомления при выполнении экстренного вызова. Например, при выполнении любого экстренного вызова сотрудник корпоративной службы безопасности может уведомляться об этом посредством мгновенного сообщения. Если местоположение абонента доступно, оно также указывается в уведомлении.

Можно задать несколько SIP URI в виде списка, разделенного запятыми. Например, -NotificationUri sip:security@litwareinc.com,sip:kmyer@litwareinc.com. Примите во внимание, что после выпуска Skype для бизнеса Server 2015 списки рассылки можно настраивать как URI уведомлений.

Длина строки должна быть в пределах от 1 до 256 символов, строка должна начинаться с префикса "sip:".

PstnUsage

Необязательный

System.String

Коммутируемая телефонная сеть общего пользования (PSTN), которая будет использоваться для определения маршрута голосового вызова, применяемого для маршрутизации вызовов 911 от клиентов с помощью данного профиля. Маршрут, связанный с использованием этой сети, должен определять магистраль SIP, специально выделенную для выполнения экстренных вызовов.

Использование этой сети должно быть уже представлено в глобальном списке использований PSTN. Вызовите командлет Get-CsPstnUsage для получения списка использований. Чтобы создать новое использование, вызовите командлет Set-CsPstnUsage .

Tenant

Необязательный

System.Guid

Уникальный глобальный идентификатор (GUID) учетной записи клиента Skype для бизнеса Online, для которого изменяется политика расположения. Пример:

–Tenant "38aad667-af54-4397-aaa7-e94c79ec2308"

Идентификатор каждого из клиентов Skype для бизнеса Online можно получить с помощью следующей команды:

Get-CsTenant | Select-Object DisplayName, TenantID

UseLocationForE911Only

Необязательный

System.Boolean

Информация о местоположении, которая может использоваться клиентом Skype для бизнеса Server 2015 по разным причинам (например, для уведомления рабочей группы о текущем местоположении). Установите значение True, чтобы информация о местоположении использовалась только при выполнении экстренных вызовов.

WhatIf

Необязательный

System.Management.Automation.SwitchParameter

Описывает, что произойдет при выполнении команды без реального выполнения команды.

Объект Microsoft.Rtc.Management.WritableConfig.Policy.Location.LocationPolicy. Принимает в качестве входных данных объекты локальных политик, переданные по конвейеру.

Этот командлет не возвращает значение или объект. Вместо этого командлет настраивает экземпляры объекта Microsoft.Rtc.Management.WritableConfig.Policy.Location.LocationPolicy.

 
Показ: