Test-CsExUMConnectivity

Skype for Business Server 2015
 

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

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

Test-CsExUMConnectivity -TargetFqdn <String> [-Authentication <TrustedServer | Negotiate | ClientCertificate | LiveID | OAuth>] [-RegistrarPort <Int32>] [-UserSipAddress <String>] <COMMON PARAMETERS>

Test-CsExUMConnectivity -UserCredential <PSCredential> -UserSipAddress <String> [-Authentication <TrustedServer | Negotiate | ClientCertificate | LiveID | OAuth>] [-HybridOnlineUserAuthentication <LiveID | OAuth>] [-HybridOnlineUserCredential <PSCredential>] [-IsHybridOnlineUser <$true | $false>] [-RegistrarPort <Int32>] [-TargetFqdn <String>] <COMMON PARAMETERS>

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

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

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

Test-CsExUMConnectivity -TargetFqdn "atl-cs-001.litwareinc.com"

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

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

$credential = Get-Credential "litwareinc\kenmyer"

Test-CsExUMConnectivity -TargetFqdn "atl-cs-001.litwareinc.com" -UserSipAddress "sip:kenmyer@litwareinc.com" -UserCredential $credential

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

$credential = Get-Credential "litwareinc\kenmyer"

Test-CsExUMConnectivity -TargetFqdn "atl-cs-001.litwareinc.com" -UserSipAddress "sip:kenmyer@litwareinc.com" -UserCredential $credential -OutLoggerVariable ExumTest

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

Командлет Test-CsExUMConnectivity проверяет, может ли указанный пользователь подключиться к службе единой системы обмена сообщениями Exchange. Обратите внимание, что данный командлет проверяет только возможность подключения к службе и не тестирует работу самой службы. Чтобы протестировать службу единой системы обмена сообщениями (запустив командлет искусственной транзакции, который оставляет сообщение голосовой почты в почтовом ящике пользователя), используйте командлет Test-CsExUMVoiceMail.

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

 

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

TargetFqdn

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

System.String

Полное доменное имя пула, для которого выполняется проверка подключения к единой системе обмена сообщениями Exchange.

UserCredential

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

System.Management.Automation.PSCredential

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

$x = Get-Credential "litwareinc\kenmyer"

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

Если тестовые пользователи, к которым применяется проверка, созданы с помощью командлетов CsHealthMonitoringConfiguration, этот параметр не обязателен.

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

HybridOnlineUserCredential

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

System.Management.Automation.PSCredential

PARAMVALUE: PSCredential

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

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

RegistrarPort

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

System.Int32

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

UserSipAddress

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

System.String

Адрес SIP пользователя, подвергаемого испытанию. Пример:

-UserSipAddress "sip:kenmyer@litwareinc.com"

Если тестовые пользователи, к которым применяется проверка, созданы с помощью командлетов CsHealthMonitoringConfiguration, этот параметр не обязателен.

Отсутствуют. Командлет Test-CsExUMConnectivity не принимает входные данные из конвейера.

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

 
Показ: