Get-CsTestDevice

Skype for Business Server 2015
 

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

Получает информацию об управлении обновлением устройств для тестовых устройств, настроенных для использования в данной организации. Тестовые устройства предоставляют администраторам способ тестирования обновлений встроенного ПО перед распределением этих обновлений по всем устройствам в организации. Данный командлет впервые появился в Lync Server 2010.

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

В примере 1 извлекаются все тестовые устройства в организации. Вызов командлета Get-CsTestDevice без использования дополнительных параметров приводит к извлечению сведений обо всех тестовых устройствах, используемых в настоящее время.

Get-CsTestDevice

В этом примере возвращается информация о тестовых устройствах с именем UCPhone, назначенных сайту Redmond.

Get-CsTestDevice -Identity site:Redmond/UCPhone

В примере 3 командная строка возвращает информацию обо всех тестовых устройствах, настроенных для сайта Redmond.

Get-CsTestDevice -Identity site:Redmond  

В примере 4 возвращается информация обо всех тестовых устройствах, настроенных на уровне сайта. Чтобы добиться этого, в команде используется параметр Filter; значение фильтра "site:*" ограничивает возвращаемые данные тестовыми устройствами, для которых значение параметра Identity начинается со строкового значения "site:".

Get-CsTestDevice -Filter site:*

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

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

Тестовые устройства могут быть назначены либо глобально, либо на уровне сайта. Командлет Get-CsTestDevice может использоваться для получения информации о тестовых устройствах, настроенных в настоящее время для использования в организации.

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

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

 

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

Filter

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

System.String

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

Identity

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

Microsoft.Rtc.Management.Xds.XdsIdentity

Указывает значение параметра Identity тестового устройства, которое должно быть возвращено. Чтобы указать отдельное устройство с именем UCPhone (хранящееся в глобальной коллекции), следует использовать следующий синтаксис: -Identity global/UCPhone. Применительно к устройству, находящемуся в семействе веб-сайтов, следует использовать примерно такой синтаксис: -Identity site:Redmond/UCPhone. Применительно ко всей коллекции, следует не указывать имя устройства. Например, для возврата информации обо всех тестовых устройствах, настроенных для сайта Redmond, следует использовать следующий синтаксис: -Identity site:Redmond.

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

LocalStore

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

System.Management.Automation.SwitchParameter

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

Нет. Командлет Get-CsTestDevice не принимает конвейерный ввод.

Командлет Get-CsTestDevice возвращает один или несколько экземпляров объекта Microsoft.Rtc.Management.WritableConfig.Settings.DeviceUpdate.TestDevice.

 
Показ: