Get-CsUserPoolInfo

Skype for Business Server 2015
 

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

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

Get-CsUserPoolInfo -Identity <UserIdParameter> [-LocalStore <SwitchParameter>]

Эта команда возвращает сведения о пуле для одного пользователя: пользователя с адресом SIP sip:kenmyer@litwareinc.com.

Get-CsUserPoolInfo "sip:kenmyer@litwareinc.com"

В примере 2 сведения о пуле возвращаются для всех пользователей, для которых включен сервер Skype для бизнеса Server 2015. Для выполнения этой задачи команда сначала вызывает командлет Get-CsUser без параметров, который возвращает коллекцию всех пользователей, для которых включена поддержка Skype для бизнеса Server 2015. Эта коллекция затем передается в командлет Get-CsUserPoolInfo , который выводит сведения о пуле для каждого пользователя в коллекции.

Get-CsUser | Get-CsUserPoolInfo

Команда, показанная в примере 3, — это видоизмененная команда из примера 2. В примере 2 сведения о пуле возвращаются для всех пользователей, для которых включен сервер Skype для бизнеса Server 2015. Однако пользователям, для которых включен сервер Skype для бизнеса Server 2015, может быть не назначен пул регистратора. Команда, показанная в примере 2, выводит сообщение об ошибке для каждого такого пользователя. Команда в примере 3 подавляет эти сообщения.

Для подавления сообщений об ошибке в примере 3 снова используется командлет Get-CsUser , который возвращает коллекцию всех пользователей с включенной поддержкой Skype для бизнеса Server 2015. Однако на этот раз коллекция передается в командлет Where-Object , который выбирает только тех пользователей, для которых значение свойства RegistrarPool не равно null (другими словами, пользователей, которым назначен пул регистратора). Отфильтрованная коллекция затем передается в командлет Get-CsUserPoolInfo , который выводит сведения о пуле для каждого пользователя в этой коллекции.

Get-CsUser | Where-Object {$_.RegistrarPool -ne $Null} | Get-CsUserPoolInfo

В примере 4 сведения о пуле выводятся для всех пользователей, которым назначен основной пул redmond-cs-001.litwareinc.com. Для этого вызывается командлет Get-CsUser с параметром Filter; значение фильтра {RegistrarPool -eq "redmond-cs-001.litwareinc.com"} возвращает только тех пользователей, для которых полное доменное имя свойства RegistrarPool имеет значение redmond-cs-001.litwareinc.com. Эта коллекция передается в командлет Get-CsUserPoolInfo , который извлекает сведения о пуле для каждого пользователя в коллекции.

Get-CsUser -Filter {RegistrarPool -eq "redmond-cs-001.litwareinc.com"} | Get-CsUserPoolInfo

Команда, показанная в примере 5, возвращает сведения о пуле для всех пользователей, которым не назначен резервный пул регистратора. Для выполнения этой задачи команда сначала вызывает командлет Get-CsUser , который возвращает коллекцию всех пользователей с включенной поддержкой Skype для бизнеса Server 2015. Эта коллекция затем передается в командлет Get-CsUserPoolInfo , который извлекает сведения о пуле для каждого пользователя в коллекции. Наконец, эти сведения передаются в командлет Where-Object , который выводит данные только для тех пользователей, для которых свойство BackupPoolFqdn имеет значение null.

Get-CsUser | Get-CsUserPoolInfo | Where-Object {$_.BackupPoolFqdn -eq $Null}

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

Get-CsUser "Ken Myer" | Select-Object RegistrarPool

Во многих случаях достаточно знать пул регистратора, назначенный пользователю. Однако в некоторых случаях может также потребоваться дополнительная информация, например назначенный пользователю резервный пул регистратора (то есть пул, который используется в случае недоступности основного пула регистратора), имена отдельных компьютеров, входящих в состав пула, и назначенный пользователю пул пользовательских служб. Такие подробные сведения можно получить с помощью командлета Get-CsUserPoolInfo .

Для Skype для бизнеса Server 2015 командлет Get-CsUserPoolInfo был изменен, чтобы возвращать информацию о пользовательских основных серверах переднего плана в основном пуле или пуле реплики. Если в пуле имеется несколько серверов переднего плана, каждому пользователю назначается группа маршрутизации, которая, в свою очередь, назначается основному серверу переднего плана и серверу переднего плана реплики. Когда пользователь входит в систему, он или она по умолчанию регистрируется с использованием основного сервера переднего плана, который в выходных данных командлета Get-CsUserPoolInfo указывается как PrimaryPoolPrimaryRegistrar. Если в основном пуле пользователя произошла отработка отказа, то пользователь регистрируется с использованием основного сервера переднего плана в резервном пуле (реплика). В выходных данных этот сервер указывается как BackupPoolPrimaryRegistrar.

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

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

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

 

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

Identity

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

Microsoft.Rtc.Management.AD.UserIdParameter

Определяет идентификатор пользователя, для которого необходимо извлечь сведения о пуле. Идентификатор можно указывать в одном из следующих четырех форматов: 1) адрес SIP пользователя; 2) имя участника-пользователя; 3) имя домена и имя входа пользователя в формате домен\имя_входа (например, litwareinc\kenmyer); 4) отображаемое имя пользователя в доменных службах Active Directory (например, Ken Myer). Также можно указать учетную запись пользователя с помощью различающегося имени пользователя в Active Directory.

При использовании отображаемого имени в качестве идентификатора пользователя можно применять подстановочный символ в виде звездочки (*). Например, если указан идентификатор "* Smith", будут возвращены сведения для пользователей, имена которых заканчиваются строкой " Smith".

LocalStore

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

System.Management.Automation.SwitchParameter

Сведения о пуле пользователя извлекаются из локальной реплики центрального хранилища управления, а не из самого центрального хранилища управления.

Строка или объект Microsoft.Rtc.Management.ADConnect.Schema.ADUser. Командлет Get-CsUserPoolInfo принимает из конвейера строковое значение, представляющее атрибут SamAccountName учетной записи пользователя, для которой включена поддержка Skype для бизнеса Server 2015. Командлет также принимает экземпляры объекта пользователя Active Directory.

Командлет Get-CsUserPoolInfo возвращает экземпляры объекта Microsoft.Rtc.Management.Xds.GetOCsUserPoolInfoCmdlet+UserInformation.

 
Показ: