Поделиться через

Get-MsolUser

  • Ссылка
Модуль:
MSOnline

Возвращает пользователей из Azure Active Directory.

Синтаксис

Get-MsolUser
   [-ReturnDeletedUsers]
   [-City <String>]
   [-Country <String>]
   [-Department <String>]
   [-DomainName <String>]
   [-EnabledFilter <UserEnabledFilter>]
   [-State <String>]
   [-Synchronized]
   [-Title <String>]
   [-HasErrorsOnly]
   [-LicenseReconciliationNeededOnly]
   [-UnlicensedUsersOnly]
   [-UsageLocation <String>]
   [-SearchString <String>]
   [-MaxResults <Int32>]
   [-TenantId <Guid>]
   [<CommonParameters>]
Get-MsolUser
   -ObjectId <Guid>
   [-ReturnDeletedUsers]
   [-TenantId <Guid>]
   [<CommonParameters>]
Get-MsolUser
   [-ReturnDeletedUsers]
   -UserPrincipalName <String>
   [-TenantId <Guid>]
   [<CommonParameters>]
Get-MsolUser
   [-ReturnDeletedUsers]
   [-City <String>]
   [-Country <String>]
   [-Department <String>]
   [-DomainName <String>]
   [-EnabledFilter <UserEnabledFilter>]
   [-State <String>]
   [-Synchronized]
   [-Title <String>]
   [-HasErrorsOnly]
   [-LicenseReconciliationNeededOnly]
   [-UnlicensedUsersOnly]
   [-UsageLocation <String>]
   [-SearchString <String>]
   [-All]
   [-TenantId <Guid>]
   [<CommonParameters>]

Описание

Командлет Get-MsolUser получает отдельного пользователя или список пользователей. Укажите параметр ObjectId или UserPrincipalName , чтобы получить определенного пользователя.

Примеры

Пример 1. Получение всех пользователей

PS C:\> Get-MsolUser

Эта команда извлекает всех пользователей в компании. По умолчанию отображается значение 500 результатов.

Пример 2. Получение включенных пользователей

PS C:\> Get-MsolUser -EnabledFilter EnabledOnly -MaxResults 2000

Эта команда получает до 2000 включенных пользователей.

Пример 3. Получение пользователя по имени участника-пользователя

PS C:\> Get-MsolUser -UserPrincipalName "davidchew@contoso.com"

Эта команда извлекает пользователя с помощью имени davidchew@contoso.comучастника-пользователя .

Пример 4. Получение пользователя по идентификатору объекта

PS C:\> Get-MsolUser -ObjectId 81701046-cb37-439b-90ce-2afd9630af7d

Эта команда извлекает пользователя с указанным идентификатором объекта.

Пример 5. Получение пользователей по строке поиска

PS C:\> Get-MsolUser -SearchString "David"

Эта команда извлекает список пользователей с Дэвидом в отображаемом имени или адресе электронной почты.

Пример 6. Получение предпочтительного расположения данных пользователя

PS C:\> Get-MsolUser -UserPrincipalName "davidchew@contoso.onmicrosoft.com" | Select PreferredDataLocation

Эта команда возвращает предпочтительное расположение данных пользователя.

Параметры

-All

Указывает, что этот командлет возвращает все результаты. Не указывайте вместе с параметром MaxResults .

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-City

Указывает город для фильтрации результатов.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Country

Указывает страну или регион для фильтрации результатов.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Department

Указывает отдел для фильтрации результатов.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-DomainName

Указывает домен для фильтрации результатов. Это должен быть проверенный домен для компании. Возвращаются все пользователи с основным или дополнительным адресом электронной почты в этом домене.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-EnabledFilter

Указывает фильтр для включенных или отключенных пользователей. Допустимые значения: All, EnabledOnly и DisabledOnly.

Тип:UserEnabledFilter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-HasErrorsOnly

Указывает, что этот командлет возвращает только пользователей с ошибками проверки.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-LicenseReconciliationNeededOnly

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

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-MaxResults

Указывает максимальное количество результатов, возвращаемых этим командлетом. Значение по умолчанию — 500.

Тип:Int32
Position:Named
Default value:500
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-ObjectId

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

Тип:Guid
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-ReturnDeletedUsers

Указывает, что этот командлет возвращает только пользователей из корзины.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-SearchString

Указывает строку, соответствующую адресу электронной почты или отображаемой имени, начиная с этой строки.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-State

Указывает фильтр для состояния пользователя.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Synchronized

Указывает, что этот командлет возвращает только пользователей, синхронизированных с помощью Синхронизации Azure Active Directory.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-TenantId

Указывает уникальный идентификатор клиента, для которого выполняется операция. Значением по умолчанию является клиент текущего пользователя. Этот параметр применяется только к пользователям партнеров.

Тип:Guid
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-Title

Копирует фильтр для заголовка пользователя.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-UnlicensedUsersOnly

Указывает, что этот командлет возвращает только пользователей, которым не назначена лицензия.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-UsageLocation

Указывает фильтр для страны или региона, где службы используются пользователем. Укажите двухбуквенный код страны или региона.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-UserPrincipalName

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

Тип:String
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

Выходные данные

Microsoft.Online.Administration.User

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

  • AlternateEmailAddresses. Альтернативный адрес электронной почты пользователя (внешний для Azure Active Directory).

  • BlockCredential. Способность пользователя осуществить вход.

  • Город. Город пользователя.

  • Country. Страна или регион пользователя.

  • Отдел. Отдел пользователя.

  • DisplayName. Отображаемое имя пользователя.

  • Ошибки. Ряд ошибок. Являются ошибками проверки и могут привести к прекращению обслуживания.

  • Факс. Номер факса пользователя.

  • Firstname. Имя пользователя.

  • ImmutableID. Возвращается только для федеративных пользователей. Это идентификатор, который требуется для федерации с Azure Active Directory.

  • isBlackBerryUser. Возвращается с информацией о наличии у пользователя устройства BlackBerry.

  • isLicensed. Наличие у пользователя назначенной лицензии.

  • LastDirSyncTime. Дата и время последней синхронизации каталогов (возвращаются только пользователями, синхронизированными с Azure Active Directory через синхронизацию Active Directory).

  • LastPasswordChangeTimestamp. Самое последнее время, когда смена пароля пользователя была зарегистрирована в Azure Active Directory.

  • LastName. Фамилия пользователя.

  • LicenseReconciliationNeeded. Наличие у пользователя почтового ящика без лицензии. В данном случае пользователю следует получить лицензию на 30 дней во избежание потери почтового ящика.

  • Лицензии. Список лицензий пользователя.

  • LiveID. Уникальный идентификатор входа пользователя.

  • MobilePhone. Номер мобильного телефона пользователя.

  • Objectid. Уникальный идентификатор пользователя.

  • Офис. Номер офиса пользователя.

  • OverallProvisioningStatus. Информация о подготовке пользователя к службам.

  • PasswordNeverExpires. Принудительная необходимость изменения пароля каждые 90 дней.

  • PhoneNumber. Номер телефона пользователя.

  • Postalcode. Почтовый код пользователя.

  • PreferredDataLocation. Предпочтительное расположение данных пользователя.

  • PreferredLanguage. Предпочитаемый язык пользователя.

  • Proxyaddresses. Адреса прокси-сервера, связанные с этим пользователем.

  • Государства. Область пользователя.

  • StreetAddress. Адрес пользователя.

  • StrongPasswordRequired. Необходимость выбора надежного пароля при изменении. Рекомендуется выбирать надежный пароль.

  • Заголовок. Название пользователя.

  • UsageLocation. Страна или регион, в которых пользователи используют службы. Это должен быть двухбуквенный код страны или региона.

  • Userprincipalname. Пользовательский идентификатор пользователя.

  • ValidationStatus. Наличие у пользователя ошибок.