Test-CsUnifiedContactStore

Skype for Business Server 2015
 

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

Проверяет, можно ли получить доступ к контактам пользователя через универсальное хранилище контактов. Универсальное хранилище контактов позволяет пользователям хранить единый набор контактов, к которому можно получить доступ с помощью Skype для бизнеса, Microsoft Outlook и/или Microsoft Outlook Web App. Этот командлет появился в Lync Server 2013.

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

Test-CsUnifiedContactStore -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-CsUnifiedContactStore [-Authentication <TrustedServer | Negotiate | ClientCertificate | LiveID | OAuth>] <COMMON PARAMETERS>

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

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

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

$credential = Get-Credential "litwareinc\kenmyer"

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

Универсальное хранилище контактов, представленное в Lync Server 2013, позволяет администраторам хранить контакты пользователей в Exchange, а не в Skype для бизнеса Server 2015. В свою очередь, это позволяет пользователям получать доступ к одному набору контактов в Outlook и Outlook Web Access, а также в Skype для бизнеса. (Вы по-прежнему можете хранить контакты в Skype для бизнеса Server 2015. В этом случае пользователям потребуется поддерживать два отдельных набора контактов: один для Outlook и Outlook Web App, а другой — для Skype для бизнеса.)

Вы можете проверить, были ли контакты пользователя перемещены в единое хранилище контактов, выполнив командлет Test-CsUnifiedContactStore . Командлет Test-CsUnifiedContactStore использует указанную учетную запись пользователя, подключается к единому хранилищу контактов и пытается получить контакт для пользователя. Если извлечь контакты не удается, команда завершатся со сбоем и выдает сообщение "No contacts were received for the user. Verify that contacts exist for the user" (Нет полученных контактов для пользователя. Убедитесь, что они существуют).

Обратите внимание на то, что Test-CsUnifiedContactStore завершается со сбоем, если пользователь успешно осуществил миграцию в единое хранилище контактов, но в его списке контактов нет ни одного контакта. Для успешного выполнения Test-CsUnifiedContactStore указанный пользователь должен иметь хотя бы один контакт.

Панель управления Lync Server: функции командлета Test-csUnifiedContactStore недоступны в панели управления Lync Server.

 

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

TargetFqdn

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

System.String

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

UserCredential

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

System.Management.Automation.PSCredential

Используемый в тесте объект учетных данных для учетной записи пользователя. Значение, переданное в параметре UserCredential, должно быть ссылкой на объект, полученной после вызова командлета G et-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-порт, используемый службой Registrar. Указание данного параметра не требуется, если служба регистратора использует стандартный порт 5061.

UserSipAddress

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

System.String

Используемый в тесте SIP-адрес пользователя. Например:

-UserSipAddress "sip:kenmyer@litwareinc.com"

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

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

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

 
Показ: