Get-MsolUser
Возвращает пользователей из 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 .
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-City
Указывает город для фильтрации результатов.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Country
Указывает страну или регион для фильтрации результатов.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Department
Указывает отдел для фильтрации результатов.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DomainName
Указывает домен для фильтрации результатов. Это должен быть проверенный домен для компании. Возвращаются все пользователи с основным или дополнительным адресом электронной почты в этом домене.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EnabledFilter
Указывает фильтр для включенных или отключенных пользователей. Допустимые значения: All, EnabledOnly и DisabledOnly.
Type: | UserEnabledFilter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-HasErrorsOnly
Указывает, что этот командлет возвращает только пользователей с ошибками проверки.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-LicenseReconciliationNeededOnly
Указывает, что этот командлет фильтрует только пользователей, которым требуется выверка лицензий.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MaxResults
Указывает максимальное количество результатов, возвращаемых этим командлетом. Значение по умолчанию — 500.
Type: | Int32 |
Position: | Named |
Default value: | 500 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ObjectId
Указывает уникальный идентификатор объекта пользователя, который требуется получить.
Type: | Guid |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ReturnDeletedUsers
Указывает, что этот командлет возвращает только пользователей из корзины.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SearchString
Указывает строку, соответствующую адресу электронной почты или отображаемой имени, начиная с этой строки.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-State
Указывает фильтр для состояния пользователя.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Synchronized
Указывает, что этот командлет возвращает только пользователей, синхронизированных с помощью Синхронизации Azure Active Directory.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TenantId
Указывает уникальный идентификатор клиента, для которого выполняется операция. Значением по умолчанию является клиент текущего пользователя. Этот параметр применяется только к пользователям партнеров.
Type: | Guid |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Title
Копирует фильтр для заголовка пользователя.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UnlicensedUsersOnly
Указывает, что этот командлет возвращает только пользователей, которым не назначена лицензия.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UsageLocation
Указывает фильтр для страны или региона, где службы используются пользователем. Укажите двухбуквенный код страны или региона.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UserPrincipalName
Копирует идентификатор пользователя, который требуется извлечь.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | 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. Наличие у пользователя ошибок.
Связанные ссылки
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по