Get-CsUCPhoneConfiguration

Skype for Business Server 2015
 

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

Возвращает информацию о параметрах управления для телефонов UC. Эта информация содержит такие сведения, как требуемый режим безопасности и возможность автоматической блокировки телефона после заданного периода бездействия. Данный командлет впервые появился в Lync Server 2010.

Get-CsUCPhoneConfiguration [-Identity <XdsIdentity>] <COMMON PARAMETERS>
Get-CsUCPhoneConfiguration [-Filter <String>] <COMMON PARAMETERS>
COMMON PARAMETERS: [-LocalStore <SwitchParameter>]

В примере 1 команда возвращает все текущие настройки конфигурации телефона UC, используемые в организации. При вызове командлета Get-CsUCPhoneConfiguration без параметров всегда возвращается полная коллекция параметров конфигурации телефона.

Get-CsUCPhoneConfiguration

В примере 2 возвращаются только настройки конфигурации телефона UC с удостоверением site:Redmond. Поскольку удостоверения должны быть уникальными, команда никогда не возвращает больше одной коллекции настроек конфигурации телефона.

Get-CsUCPhoneConfiguration -Identity site:Redmond

В примере 3 возвращаются все параметры телефона UC, заданные в области действия сайта. Для этого вызывается командлет Get-CsUCPhoneConfiguration и используется параметр Filter; значение фильтра "site:*" ограничивает возвращаемые данные параметрами, для которых свойство Identity (единственное свойство, по которому можно выполнять фильтрацию) начинается со строкового значения "site:". По определению все параметры, для которых удостоверение начинается со строкового значения "site:", являются параметрами, заданными в области действия сайта.

Get-CsUCPhoneConfiguration -Filter site:*

В примере 4 возвращаются параметры конфигурации телефона UC, в которых для режима безопасности SIP задано значение Medium (для безопасности SIP можно задать значение Low (низкий), Medium (средний) или High (высокий)). Для выполнения этой задачи в команде сначала используется командлет Get-CsUCPhoneConfiguration без дополнительных параметров, чтобы получить коллекцию всех параметров телефона UC, заданных для применения в организации. Затем эта коллекция передается командлету Where-Object , выбирающему только те параметры, у которых свойство SIPSecurityMode имеет значение Medium.

Get-CsUCPhoneConfiguration | Where-Object {$_.SIPSecurityMode -eq "Medium"}

В примере 5 возвращаются параметры телефона UC, соответствующие одному из следующих критериев (или обоим): 1) блокировка телефона не применяется; 2) минимальная длина ПИН-кода меньше 6 цифр. Для этого команда сначала вызывает командлет Get-CsUCPhoneConfiguration , чтобы получить коллекцию всех текущих параметров конфигурации телефона UC, используемых в организации. Затем эта коллекция передается командлету Where-Object , который выбирает элементы, соответствующие одному из следующих критериев (или обоим): 1) свойство EnforcePhoneLock имеет значение False; 2) свойство MinPhonePinLength меньше 6.

При использовании оператора -or командлет Where-Object будет выбирать параметры, соответствующие одному из двух критериев (или обоим). Для выбора параметров, соответствующих обоим критериям (в данном случае это означает, что блокировка телефона не применяется и длина ПИН-кода меньше 6), используйте оператор -and:

Where-Object {$_.EnforcePhoneLock -eq $False -and $_.MinPhonePinLength -lt 6}

Get-CsUCPhoneConfiguration | Where-Object {$_.EnforcePhoneLock -eq $False -or $_.MinPhonePinLength -lt 6}

Телефоны UC объединяют телефон и Skype для бизнеса Server 2015. Lync Phone Edition использует специальное оборудование (то есть телефон, совместимый с Skype для бизнеса), которое может функционировать как VoIP-телефон. Кроме того, это оборудование также может действовать как конечная точка Skype для бизнеса: можно задать свой текущий статус, проверить статус своих контактов в Skype для бизнеса, можно задать свой текущий статус, проверить статус своих контактов в Skype для бизнеса.

Командлеты CsUCPhoneConfiguration позволяют управлять телефонами UC. Например, вы можете определять минимальную длину персонального идентификационного номера (PIN), который используется для входа в телефон, а также задавать автоматическую блокировку телефона после указанного периода бездействия.

Настройки конфигурации телефона можно применять на глобальном уровне или в области действия сайта. (Настройки, применяемые в области действия сайта, имеют более высокий приоритет, чем настройки, применяемые глобально.) С помощью командлета Get-CsUCPhoneConfiguration можно получить информацию о текущих настройках конфигурации телефона, действующих в организации.

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

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

 

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

Filter

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

System.String

Позволяет использовать подстановочные знаки для получения коллекции (или коллекций) настроек конфигурации телефона UC. Для получения коллекции всех настроек, заданных в области действия сайта, используйте следующий синтаксис: -Filter site:*. Для получения коллекции всех настроек, содержащих строковое значение "EMEA" где-либо в свойстве Identity (единственное свойство, которое можно использовать для фильтрации), используйте следующий синтаксис: -Filter *EMEA*.

Identity

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

Microsoft.Rtc.Management.Xds.XdsIdentity

Указывает уникальный идентификатор для коллекции настроек конфигурации телефона в системе объединенных коммуникаций (UC), которую вы хотите получить. Для глобальных настроек используйте следующий синтаксис: -Identity global. Для коллекции, заданной в области действия сайта, используйте синтаксис следующего вида: -Identity "site:Redmond". Помните, что при указании параметра Identity нельзя использовать подстановочные знаки. Если необходимо использовать подстановочные знаки, вместо этого параметра включите в команду параметр Filter.

Если этот параметр не указан, Get-CsUCPhoneConfiguration возвращает коллекцию всех параметров конфигурации телефона UC, используемых в организации.

LocalStore

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

System.Management.Automation.SwitchParameter

Получает данные конфигурации телефона UC из локальной реплики управления, а не из управления.

Нет. Get-CsUCPhoneConfiguration не принимает конвейерные входные данные.

Get-CsUCPhoneConfiguration возвращает экземпляры объекта Microsoft.Rtc.Management.WritableConfig.Policy.Voice.UcPhoneSettings.

 
Показ: