Get-CsAudioTestServiceApplication

Skype for Business Server 2015
 

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

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

Get-CsAudioTestServiceApplication [-Identity <UserIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-OU <OUIdParameter>] [-ResultSize <Unlimited>]

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

Get-CsAudioTestServiceApplication

В примере 2 возвращается один контакт службы проверки аудиосвязи: контакт, который обладает удостоверением sip:RedmondAudioTest@litwareinc.com.

Get-CsAudioTestServiceApplication -Identity "sip:RedmondAudioTest@litwareinc.com"

В примере 3 возвращаются все контакты службы проверки аудиосвязи, отображаемое имя которых включает строковый параметр "Redmond". При этом команда использует параметр Filter и значение фильтра {DisplayName –like "*Redmond*"}; это значение фильтра ограничивает возвращаемые данные контактами, отображаемое имя которых включает строковый параметр "Redmond". Эта команда возвращает контакты с такими отображаемыми именами, как "Redmond Audio Test Service Contact", "Redmond Audio Bot" и "Test Contact for Redmond".

Get-CsAudioTestServiceApplication -Filter {DisplayName -like "*Redmond*"}

Служба проверки аудиосвязи предоставляет пользователям Skype для бизнеса Server 2015 возможность проверки голосовых подключений перед выполнением голосового вызова. Для этого пользователи щелкают кнопку проверки качества вызова, расположенную на вкладке "Audio Device" (Аудиоустройство) диалогового окна "Функции" Skype для бизнеса Server 2015. Когда пользователь щелкает эту кнопку, выполняется вызов службы автоматизированной проверки аудиосвязи. Выполняется ответ на вызов, и после воспроизведения вводных инструкций абонента просят записать короткое сообщение. Эта запись затем воспроизводится повторно, благодаря чему абонент сможет прослушать, каким образом воспроизводится его голос посредством текущего соединения.

Служба проверки аудиосвязи частично зависит от объектов контактов Active Directory. Данные объекты создаются автоматически при установке программы-робота для работы со звуком; эти объекты нельзя создать вручную. Однако администраторы могут использовать командлет Get-CsAudioTestServiceApplication для получения данных о различных контактах службы проверки, в данный момент используемых организацией. Администраторы также могут применить команду Set-CsAudioTestServiceApplication для изменения свойств этих контактов.

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

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

 

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

Credential

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

System.Management.Automation.PSCredential

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

Чтобы использовать параметр Credential, необходимо сначала создать объект PSCredential с помощью командлета Get-Credential . Дополнительные сведения см. в разделе справки, посвященном командлету Get-Credential .

DomainController

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

Microsoft.Rtc.Management.Deploy.Fqdn

Позволяет подключиться к определенному контроллеру домена для получения контактных данных. Для подключения к определенном контроллеру домена включите параметр DomainController с последующим именем компьютера (пример: atl-cs-001) или полным доменным именем (FQDN) (пример: atl-cs-001.litwareinc.com).

Filter

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

System.String

Позволяет ограничивать возвращаемые данные путем фильтрации специальных атрибутов для Skype для бизнеса Server 2015. Например, можно ограничить возвращаемые данные контактными объектами проверки аудиосвязи, которые обладают определенным отображаемым именем или используют определенный язык.

Параметр Filter использует такой же синтаксис фильтрации Windows PowerShell, который используется командлетом Where-Object . Например, фильтр, который возвращает только контакты, обладающие отображаемым именем "Audio Test Service Contacts", будут выглядеть следующим образом (DisplayName представляет атрибут Active Directory, -eq представляет оператор сравнения (равно), а "Audio Test Service Contact" представляет значение фильтрации:

-Filter {DisplayName -eq "Audio Test Service Contact"}

В одной команде нельзя одновременно использовать параметры Filter и Identity.

Identity

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

Microsoft.Rtc.Management.AD.UserIdParameter

Адрес SIP контакта службы проверки аудиосвязи.

OU

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

Microsoft.Rtc.Management.AD.OUIdParameter

Позволяет возвращать контакты из определенного подразделения (OU) Active Directory. Параметр (OU) возвращает данные и из указанного подразделения, и из всех его дочерних подразделений. Например, если у финансового подразделения есть два дочерних подразделения (AccountsPayable и AccountsReceivable), будет возвращен список пользователей из каждого из этих трех подразделений.

При указании подразделения используйте отличительное имя (DN) этого контейнера; пример: -OU "OU=Finance,dc=litwareinc,dc=com".

ResultSize

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

Microsoft.Rtc.Management.ADConnect.Core.Unlimited

Позволяет ограничивать количество записей, возвращаемых командой. Например, чтобы вернуть семь записей пользователей (независимо от количества пользователей в лесу), включите параметр ResultSize и задайте значение параметра, равное 7. Обратите внимание, что нельзя точно указать, записи каких семи пользователей будут возвращены. Если задано значение ResultSize, равное 7, но в лесу доступны только три пользователя, команда возвращает записи этих трех пользователей и выполняет завершение без генерации ошибки.

В качестве размера результатов может быть указано любое целое число в диапазоне от 0 до 2147483647 включительно. При задании значения "0" команда будет выполняться, но данные возвращаться не будут.

Командлет Get-CsAudioTestServiceApplication возвращает экземпляры объекта Microsoft.Rtc.Management.ADConnect.Schema.OCSADApplicationContact.

 
Показ: