Get-CsUserAcp

Skype for Business Server 2015
 

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

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

Get-CsUserAcp [-Identity <UserIdParameter>] [-Credential <PSCredential>] [-Filter <String>] [-LdapFilter <String>] [-ResultSize <Unlimited>]

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

Get-CsUserAcp

В примере 2 извлекаются сведения о поставщике аудиоконференций для одного пользователя с удостоверением Ken Myer. В данном случае удостоверение указывается с помощью отображаемого имени пользователя в Active Directory.

Get-CsUserAcp -Identity "Ken Myer"

В примере 3 извлекаются сведения для всех пользователей, которым назначен хотя бы один поставщик аудиоконференций. Для этого включается параметр Filter вместе со значением фильтра {AcpInfo -ne $Null}; данное значение фильтра ограничивает извлекаемые данные теми пользователями, значение свойства AcpInfo которых не равно значению NULL. Чтобы извлечь сведения о пользователях, которым не назначен поставщик аудиоконференций, используйте следующее значение фильтра:

{AcpInfo -eq $Null}

Get-CsUserAcp -Filter {AcpInfo -ne $Null}

В примере 4 извлекаются сведения о поставщике аудиоконференций для тех пользователей, которым назначен поставщик аудиоконференций Fabrikam ACP. Чтобы выполнить эту задачу, команда сначала извлекает сведения о поставщике аудиоконференций для всех пользователей в организации с помощью командлета Get-CsUserAcp . Затем эти сведения передаются в командлет Where-Object , выбирающий тех пользователей, свойство AcpInfo которых включает (-match) строковое значение "Fabrikam ACP".

Get-CsUserAcp | Where-Object {$_.AcpInfo -match "Fabrikam ACP"}

В примере 5 выводятся подробные сведения о поставщиках аудиоконференций, назначенных пользователю Ken Myer. Для этого сначала вызывается командлет Get-CsUserAcp , который возвращает сведения о поставщиках аудиоконференций для пользователя Ken Myer. Затем эти данные передаются в командлет Select-Object , который использует параметр ExpandProperty, чтобы "развернуть" значение свойства AcpInfo. Когда значение свойства разворачивается, все сведения, хранящиеся в этом значении, отображаются в удобном для чтения формате.

Get-CsUserAcp -Identity "Ken Myer" | Select-Object -ExpandProperty AcpInfo

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

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

Командлет Get-CsUserAcp позволяет извлечь сведения о поставщиках аудиоконференций, назначенных пользователю или группе пользователей. Чтобы извлечь сведения о поставщиках аудиоконференций для одного пользователя, просто включите параметр Identity, после которого укажите удостоверение пользователя, сведения о котором требуется получить. Чтобы извлечь сведения для нескольких пользователей, можно использовать параметр LdapFilter или Filter. Параметр LdapFilter позволяет использовать универсальные атрибуты Active Directory, такие как Department или Title, при указании сведений об учетной записи пользователя; например, значение параметра "Title=Accountant" ограничивает извлекаемые сведения теми пользователями, чья должность называется Accountant. Параметр Filter позволяет использовать атрибуты Skype для бизнеса Server 2015 (например, VoicePolicy или EnterpriseVoiceEnabled) для фильтрации извлекаемых данных. Например, значение фильтра {EnterpriseVoiceEnabled –eq $True} ограничивает извлекаемые командлетом Get-CsUserAcp учетные записи пользователями, для которых включена корпоративная голосовая связь.

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

 

Параметр Применение Тип Описание

Credential

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

System.Management.Automation.PSCredential

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

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

Filter

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

System.String

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

В параметре Filter используется тот же синтаксис фильтрации Windows PowerShell, который используется командлетом Where-Object . Например, фильтр, возвращающий только пользователей, для которых включена корпоративная голосовая связь, может выглядеть следующим образом, где EnterpriseVoiceEnabled представляет атрибут доменных служб Active Directory, -eq — это оператор сравнения (равно), а $True (встроенная переменная Windows PowerShell) представляет значение фильтра:

{EnterpriseVoiceEnabled -eq $True}

Identity

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

Microsoft.Rtc.Management.AD.UserIdParameter

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

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

LdapFilter

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

System.String

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

В параметре LdapFilter для создания фильтров используется язык запросов LDAP. Например, фильтр, возвращающий пользователей, работающих только в городе Редмонд, выглядит так: "l=Redmond", где "l" (строчная буква L) обозначает атрибут Active Directory (locality, местоположение); "=" обозначает оператор сравнения (равняется); а "Redmond" обозначает фильтруемое значение.

ResultSize

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

Microsoft.Rtc.Management.ADConnect.Core.Unlimited

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

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

String (строка). Командлет Get-CsUserAcp принимает конвейерное строковое значение, обозначающее удостоверение учетной записи пользователя, которому был разрешен доступ к Skype для бизнеса Server 2015.

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

 
Показ: