Get-CsUser

Skype for Business Server 2015
 

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

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

Get-CsUser [-Identity <UserIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-LdapFilter <String>] [-OnModernServer <SwitchParameter>] [-OnOfficeCommunicationServer <SwitchParameter>] [-OU <OUIdParameter>] [-ResultSize <Unlimited>] [-UnassignedUser <SwitchParameter>]

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

В примере 2 командлет Get-CsUser возвращает коллекцию всех пользователей домена, которым был разрешен доступ к Skype для бизнеса Server 2015. По умолчанию Get-CsUser возвращает очень много свойств и их значений, большинство из которых в данной ситуации не представляет интереса. Поэтому в этом примере полученные данные передаются командлету Format-Table . Затем Format-Table с помощью параметра Property выбирает свойства DisplayName, SipAddress и EnterpriseVoiceEnabled и отображает эти свойства и их значения в таблице.

Get-CsUser | Format-Table -Property DisplayName, SipAddress, EnterpriseVoiceEnabled -AutoSize

В примере 3 используется параметр Identity, чтобы включить в возвращаемые данные только учетную запись пользователя с удостоверением (в данном случае отображаемым именем) Pilar Ackerman.

Get-CsUser -Identity "Pilar Ackerman"

В примере 4 при указании удостоверения пользователя используется подстановочный знак (*). В результате Get-CsUser возвращает список всех пользователей, удостоверение которых начинается со строкового значения "Pilar".

Get-CsUser -Identity "Pilar*"

В примере 5 команда возвращает коллекцию пользователей, которым не назначена политика голосовых служб на уровне пользователя. Для этого в команде используется параметр Filter, за которым следует фильтр VoicePolicy -eq "$Null. При создании фильтров для командлета Get-CsUser необходимо указывать имя свойства (VoicePolicy) и оператор сравнения (в данном случае "eq", оператор сравнения, означающий "равняется"). Сразу после оператора сравнения указывается проверяемое значение. В данном примере это значение $Null, переменная командной строки Windows PowerShell, представляющая нулевое значение.

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

Get-CsUser -Filter {VoicePolicy -ne $Null}

Get-CsUser -Filter {VoicePolicy -eq $Null}

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

Get-CsUser -LdapFilter "Department=Finance"

В примере 7 демонстрируется применение запроса AND в сочетании с параметром LdapFilter. В этом запросе (в котором используется знак "&" для указания запроса AND) задаются два условия: "Department=Finance" и "Title=Manager". Для учетной записи пользователя, возвращаемой по этому запросу, должны быть соблюдены оба условия: пользователь должен работать в финансовом отделе и быть менеджером.

Get-CsUser -LdapFilter "&(Department=Finance)(Title=Manager)"

В команде примера 8 используется запрос OR (обозначаемый знаком "|") вместе с параметром LdapFilter. В запросе AND, показанном в примере 7, для возвращения учетной записи пользователя должны были соблюдаться оба условия. В запросе OR для этого должно быть соблюдено только одно условие. В данном случае учетная запись пользователя возвращается, если пользователь является руководителем или менеджером.

Get-CsUser -LdapFilter "|(Title=Supervisor)(Title=Manager)"

В примере 9 возвращается информация об учетной записи пользователя для всех пользователей с учетными записями в финансовом подразделении.

Get-CsUser -OU "ou=Finance,ou=North America,dc=litwareinc,dc=com"

В примере 10 возвращается коллекция всех пользователей, которым был разрешен доступ к Skype для бизнеса Server 2015, но которые в настоящее время не назначены пулу Registrar.

Get-CsUser -UnassignedUser

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

Функции двух командлетов в некоторой степени перекрываются, но Get-CsUser и Get-CsAdUser отличаются типом возвращаемой информации. Как правило, 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-CsUser , введите в командной строке Windows PowerShell следующую команду:

Get-CsUser | Get-Member

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

 

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

Credential

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

System.Management.Automation.PSCredential

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

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

DomainController

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

Microsoft.Rtc.Management.Deploy.Fqdn

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

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.

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

LdapFilter

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

System.String

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

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

OnModernServer

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

System.Management.Automation.SwitchParameter

PARAMVALUE: SwitchParameter

OnOfficeCommunicationServer

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

System.Management.Automation.SwitchParameter

Возвращает коллекцию пользователей Office Communications Server 2007. Пользователи с учетными записями из текущей версии программного обеспечения не возвращаются при использовании этого параметра.

OU

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

Microsoft.Rtc.Management.AD.OUIdParameter

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

При указании подразделения используйте различающееся имя (DN) этого контейнера, например: -OU "OU=Finance,dc=litwareinc,dc=com". Чтобы вернуть учетные записи пользователей из контейнера "Пользователи", используйте этот синтаксис:

-OU "cn=Users,dc=litwareinc,dc=com"

ResultSize

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

Microsoft.Rtc.Management.ADConnect.Core.Unlimited

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

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

UnassignedUser

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

System.Management.Automation.SwitchParameter

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

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

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

 
Показ: