Get-CsAdUser

Skype for Business Server 2015
 

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

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

Get-CsAdUser [-Identity <UserIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-LDAPFilter <String>] [-OU <OUIdParameter>] [-ResultSize <Unlimited>]

Команда из примера 1 возвращает коллекцию всех учетных записей в вашем домене Active Directory.

Get-CsAdUser

В примере 2 командлет Get-CsAdUser возвращает данные учетной записи для пользователя Pilar Ackerman. Для идентификации пользователя используется его отображаемое имя.

Get-CsAdUser -Identity "Pilar Ackerman"

В примере 3 запрашивается информация обо всех пользователях в подразделении Finance. Для этого в качестве параметра OU передается доменное имя подразделения.

Get-CsAdUser -OU "ou=Finance,dc=litwareinc,dc=com"

В примере 4 запрашиваются все пользователи, которые не имеют доступ к функциям Skype для бизнеса Server 2015. Для этого используется параметр Filter команды Get-CsAdUser , что позволяет получить только те записи, у которых свойство Enabled не имеет значения True. Фильтр команды Get-CsAdUser позволяет получить только тех пользователей, которые не могут использоваться в Skype для бизнеса Server 2015. Полученные данные передаются в командлет Select-Object , выбирающий свойство (в данном случае DisplayName), которое будет показано на экране.

Get-CsAdUser -Filter {Enabled -ne $True} | Select-Object DisplayName

В примере 5 используется параметр LdapFilter для получения данных о пользователях, работающих в финансовом отделе. В качестве фильтра используется значение "Department=Finance".

Get-CsAdUser -LdapFilter "Department=Finance"

Командлет Get-CsAdUser возвращает сведения обо всех учетных записях пользователей в Active Directory, включая записи, разрешенные и не разрешенные для использования в Skype для бизнеса Server 2015. Это отличает команду от Get-CsUser , которая возвращает сведения только по пользователям, которые разрешены для применения в Skype для бизнеса Server 2015 и в более ранних версиях программного обеспечения.

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

Напротив, командлет Get-CsAdUser возвращает значения общих атрибутов Active Directory, то есть возвращает сведения об атрибутах, входящих в базовую учетную запись Active Directory независимо от того, включена ли для пользователя поддержка Skype для бизнеса Server 2015. Например, командлет Get-CsAdUser возвращает такие сведения, как организация и отдел, в которых работает пользователь, его должность, телефонный номер и номер кабинета. Чтобы увидеть полный список атрибутов, возвращаемых командлетом Get-CsAdUser , в командной строке Windows PowerShell введите следующую команду:

Get-CsAdUser | Get-Member

Командлет Get-CsAdUser предоставляет несколько способов фильтрации полученной коллекции пользователей. Например, если не требуется получать все учетные записи, можно использовать необязательные параметры Filter и LdapFilter. Это взаимоисключающие параметры: в одной команде нельзя использовать их одновременно. Параметр Filter позволяет получить данные о пользователях, соответствующих определенным критериям в атрибутах Skype для бизнеса Server 2015. Например, можно получить коллекцию пользователей, для которых включена поддержка Skype для бизнеса Server 2015. Параметр LdapFilter позволяет получать данные о пользователях, соответствующих другим критериям на основе базовых атрибутов Active Directory, например, о пользователях, которые работают в указанной области или регионе, пользователях с пейджером или пользователях с определенной должностью.

Важное замечание насчет командлета Get-CsAdUser : несмотря на то что атрибут Enabled, определяющий, включена ли для пользователя поддержка Skype для бизнеса Server 2015, имеет логическое значение, на самом деле в этом свойстве допускается использовать три значения:

True — пользователь может использовать Skype для бизнеса Server 2015.

False — у пользователя временно отключена учетная запись Skype для бизнеса Server 2015. Обычно это выполняется путем вызова командлета Set-CsUser и присвоения параметру Enabled значения $False.

Null — пользователь не может применять Skype для бизнеса Server 2015.

То есть для получения списка всех пользователей, которые не могут применять Skype для бизнеса Server 2015, следует выполнять команду, которая возвращает всех пользователей, значение атрибута Enabled которых равно NULL:

Get-CsAdUser –Filter {Enabled –eq $Null}

Следующая команда, напротив, получает только тех пользователей, у которых временно отключены учетные записи Skype для бизнеса Server 2015:

Get-CsAdUser –Filter {Enabled –eq $False}

При выполнении команды выше не будут получены пользователи, которые не были активированы для применения Skype для бизнеса Server 2015.

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

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

 

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

Credential

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

System.Management.Automation.PSCredential

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

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

DomainController

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

Microsoft.Rtc.Management.Deploy.Fqdn

Позволяет подключиться к определенному контроллеру домена для получения сведений о пользователе.. Укажите параметр DomainController с полным доменным именем (например, atl-cs-001.litwareinc.com).

Filter

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

System.String

Фильтрует возвращаемые данные по атрибутам, относящимся к Skype для бизнеса Server 2015.

Параметр Filter использует такой же синтаксис фильтрации Windows PowerShell, что и командлет Where-Object . Например, фильтр для получения пользователей, которым не разрешено использование Skype для бизнеса Server 2015, будет выглядеть так: {Enabled -ne $True}, где Enabled — это атрибут Active Directory, "-ne" является оператором сравнения (не равно) и $True (встроенная переменная Windows PowerShell) представляет значение True.

Identity

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

Microsoft.Rtc.Management.AD.UserIdParameter

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

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

LDAPFilter

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

System.String

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

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

OU

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

Microsoft.Rtc.Management.AD.OUIdParameter

Позволяет получить данные о пользователях из определенного подразделения Active Directory или контейнера. Данный параметр обеспечивает получение данных как из указанного подразделения, так и из его дочерних подразделений. Например, если подразделение Finance имеет два дочерних подразделения — AccountsPayable и AccountsReceivable, — будут получены данные о пользователях всех трех подразделений.

При указании подразделения используйте различающееся имя контейнера; например: OU=Finance,dc=litwareinc,dc=com. Для получения пользователей из контейнера Users, используйте следующий синтаксис: cn=Users,dc=litwareinc,dc=com.

ResultSize

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

Microsoft.Rtc.Management.ADConnect.Core.Unlimited

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

В качестве размера результата можно задать любое целое число от 0 до 2147483647 включительно. Если задано значение 0, команда выполняется, но данные не возвращаются. Если в лес входят только 3 пользователя, а параметру ResultSize задано значение 7, то команда вернет этих трех пользователей, а затем завершится без ошибки.

Строка. Командлет Get-CsAdUser принимает из конвейера строковые значения, представляющие идентификаторы учетных записей пользователей Active Directory.

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

 
Показ: