Test-CsExUMVoiceMail

Skype for Business Server 2015
 

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

Позволяет пользователю подключиться к службе единой системы обмена сообщениями Exchange (UM) и оставить голосовое сообщение другому пользователю. Данный командлет впервые появился в Lync Server 2013.

Test-CsExUMVoiceMail -TargetFqdn <String> [-Authentication <TrustedServer | Negotiate | ClientCertificate | LiveID | OAuth>] [-ReceiverSipAddress <String>] [-RegistrarPort <Int32>] [-SenderSipAddress <String>] [-WaveFile <String>] <COMMON PARAMETERS>

Test-CsExUMVoiceMail -ReceiverSipAddress <String> -SenderCredential <PSCredential> -SenderSipAddress <String> [-Authentication <TrustedServer | Negotiate | ClientCertificate | LiveID | OAuth>] [-HybridOnlineUserAuthentication <LiveID | OAuth>] [-IsHybridOnlineUser <$true | $false>] [-RegistrarPort <Int32>] [-TargetFqdn <String>] [-WaveFile <String>] <COMMON PARAMETERS>

Test-CsExUMVoiceMail [-Authentication <TrustedServer | Negotiate | ClientCertificate | LiveID | OAuth>] <COMMON PARAMETERS>

COMMON PARAMETERS: [-Force <SwitchParameter>] [-OutLoggerVariable <String>] [-OutVerboseVariable <String>]

В предыдущем примере проверяется возможность подключения к голосовой почте Exchange Unified Messaging пула atl-cs-001.litwareinc.com. Эта команда работает только если для пула atl-cs-001.litwareinc.com заданы тестовые пользователи. В этом случае команда определит, может ли первый тестовый пользователь использовать голосовую почту Unified Messaging. Если для пула не заданы тестовые пользователи, команду выполнить не удастся.

Test-CsExUMVoiceMail -TargetFqdn "atl-cs-001.litwareinc.com" -ReceiverSipAddress "sip:kenmyer@litwareinc.com"

Команды, приведенные в примере 2, используются для проверки возможности подключения пользователя litwareinc\kenmyer к голосовой почте единой системы обмена сообщениями Microsoft Exchange. Для этого первая команда использует командлет Get-Credential , чтобы создать объект учетных данных командной строки Windows PowerShell для пользователя litwareinc\kenmyer. Обратите внимание на то, что для создания действительного объекта учетных данных и гарантированного выполнения проверки командлетом Test-CsExUMVoiceMail необходимо предоставить пароль учетной записи.

Вторая команда в примере проверяет с помощью готового объекта учетной записи ($x) и SIP-адреса пользователя litwareinc\kenmyer может ли этот пользователь установить подключение к голосовой почте Exchange Unified Messaging.

$credential = Get-Credential "litwareinc\pilar"

Test-CsExUMVoiceMail -TargetFqdn "atl-cs-001.litwareinc.com" -ReceiverSipAddress "sip:kenmyer@litwareinc.com" -SenderSipAddress "sip:pilar@litwareinc.com" -SenderCredential $credential

Команда в примере 3 похожа на команду из примера 1, но в данном случае в нее включен параметр OutLoggerVariable, позволяющий составить подробный отчет о каждом шаге, выполненном командлетом Test-CsExUMVoiceMail , и результатах. Для этого параметр OutLoggerVariable добавляется со значением ExumText. Благодаря этому в переменной $ExumTest сохраняется подробный отчет. Последняя команда в примере использует метод ToXML() для преобразования отчета в формат XML. Затем данные XML записываются в файл C:\Logs\VoicemailTest.xml с помощью командлета Out-File.

Test-CsExUMVoiceMail -TargetFqdn "atl-cs-001.litwareinc.com" -ReceiverSipAddress "sip:kenmyer@litwareinc.com" -OutLoggerVariable VoicemailTest

$VoicemailTest.ToXML() | Out-File C:\Logs\VoicemailTest.xml

Командлет Test-CsExUMVoiceMail позволяет администраторам проверять, есть ли у пользователей доступ к службе единой системы обмена сообщениями Exchange и используют ли они ее. Для этого командлет подключается к службе единой системы обмена сообщениями и оставляет голосовое сообщение в нужном почтовом ящике. Это может быть системное голосовое сообщение или WAV-файл, записанный администратором.

Панель Панель управления Skype для бизнеса Server: функции командлета Test-CsExUMVoiceMail недоступны в панели Skype для бизнеса Server 2015.

 

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

SenderCredential

Обязательный?

System.Management.Automation.PSCredential

Объект учетных данных пользователя, оставляющего голосовое сообщение. Значение, передаваемое параметру SenderCredential, должно представлять собой ссылку на объект, полученную с помощью командлета Get-Credential . Например, следующий код возвращает объект учетных данных для пользователя litwareinc\kenmyer и сохраняет этот объект в переменную $x:

$x = Get-Credential "litwareinc\kenmyer"

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

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

TargetFqdn

Обязательный?

System.String

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

-TargetFqdn atl-cs-001.litwareinc.com

Authentication

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

Microsoft.Rtc.Management.SyntheticTransactions.SipSyntheticTransaction+AuthenticationMechanism

Тип проверки подлинности, используемой при выполнении теста. Допускаются следующие значения:

* TrustedServer

* Negotiate

* ClientCertificate

* LiveID

Force

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

System.Management.Automation.SwitchParameter

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

HybridOnlineUserAuthentication

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

Microsoft.Rtc.Management.SyntheticTransactions.SipSyntheticTransaction+HybridOnlineAuthenticationMechanism

PARAMVALUE: LiveID | OAuth

IsHybridOnlineUser

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

System.Boolean

PARAMVALUE: $true | $false

OutLoggerVariable

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

System.String

Если этот параметр используется, подробные результаты выполнения командлета будут сохранены в указанной переменной. Эта переменная включает в себя пару методов, ToHTML и ToXML, которые затем могут использоваться для сохранения этих результатов в HTML-файле или в XML-файле.

Для сохранения выходных результатов в переменной средства ведения журнала с именем $TestOutput используется следующий синтаксис:

-OutLoggerVariable TestOutput

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

Чтобы записать в HTML-файл данные, хранящиеся в переменной средства ведения журнала, используйте следующую команду:

$TestOutput.ToHTML() > C:\Logs\TestOutput.html

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

$TestOutput.ToXML() > C:\Logs\TestOutput.xml

OutVerboseVariable

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

System.String

При указании этого параметра подробные результаты выполнения командлета будут сохранены в указанной переменной. Например, чтобы сохранить результаты в переменную $TestOutput, используйте следующий синтаксис:

-OutVerboseVariable TestOutput

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

ReceiverSipAddress

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

System.String

SIP-адрес учетной записи пользователя, который должен получить тестовое голосовое сообщение (этот SIP-адрес должен отличаться от SIP-адреса отправителя). Например:

-ReceiverSipAddress "sip:pilar@litwareinc.com"

Данные учетной записи получателя не требуются.

RegistrarPort

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

System.Int32

Порт SIP, используемый службой регистратора. Этот параметр не обязателен, если регистратор использует порт по умолчанию, 5061.

SenderSipAddress

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

System.String

SIP-адрес учетной записи пользователя, который будет отправлять голосовое сообщение (этот SIP-адрес должен отличаться от SIP-адреса получателя). Например:

-SenderSipAddress "sip:kenmyer@litwareinc.com"

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

SIP-адрес не требуется, если тест выполняется с параметрами конфигурации наблюдения за работоспособностью для пула.

WaveFile

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

System.String

Путь к аудиофайлу WAV, который можно использовать для проверки службы голосовой почты. Если этот параметр указан, командлет Test-CsExUMVoiceMail воспроизводит указанный файл WAV при подключении к голосовой почте Exchange. Если этот параметр не указан, проигрывается аудиофайл, назначенный по умолчанию.

Нет. Командлет Test-CsExUMVoiceMail не принимает входные данные из конвейера.

Командлет Test-CsExUMVoiceMail возвращает экземпляр объекта Microsoft.Rtc.SyntheticTransactions.TaskOutput.

 
Показ: