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


Get-AzureADUser

Возвращает пользователя.

Синтаксис

Get-AzureADUser
   [-All <Boolean>]
   [-Top <Int32>]
   [-Filter <String>]
   [<CommonParameters>]
Get-AzureADUser
   [-SearchString <String>]
   [-All <Boolean>]
   [<CommonParameters>]
Get-AzureADUser
   -ObjectId <String>
   [-All <Boolean>]
   [<CommonParameters>]

Описание

Командлет Get-AzureADUser получает пользователя из идентификатора Microsoft Entra.

Примеры

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

PS C:\>Get-AzureADUser -Top 10

Эта команда получает 10 пользователей.

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

PS C:\>Get-AzureADUser -ObjectId "testUpn@tenant.com"

Эта команда получает указанного пользователя.

Пример 3. Поиск среди извлеченных пользователей

PS C:\> Get-AzureADUser -SearchString "New"

ObjectId                             DisplayName UserPrincipalName                   UserType
--------                             ----------- -----------------                   --------
5e8b0f4d-2cd4-4e17-9467-b0f6a5c0c4d0 New user    NewUser@contoso.onmicrosoft.com     Member
2b450b8e-1db6-42cb-a545-1b05eb8a358b New user    NewTestUser@contoso.onmicrosoft.com Member

Этот командлет получает всех пользователей, которые соответствуют значению SearchString и первым символам в DisplayName или UserPrincipalName.

Пример 4. Получение пользователя по userPrincipalName

PS C:\>Get-AzureADUser -Filter "userPrincipalName eq 'jondoe@contoso.com'"

Эта команда получает указанного пользователя.

Пример 5. Получение пользователя с помощью JobTitle

PS C:\>Get-AzureADUser -Filter "startswith(JobTitle,'Sales')"

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

Параметры

-All

Если задано значение true, возвращаются все пользователи. Если задано значение false, возвращается количество объектов, указанное параметром Top.

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

-Filter

Указывает инструкцию фильтра OData версии 3.0. Этот параметр определяет, какие объекты возвращаются. Подробные сведения о запросах с помощью OData можно найти здесь. http://www.odata.org/documentation/odata-version-3-0/odata-version-3-0-core-protocol/#queryingcollections. В настоящее время поддерживаются не все функции и операторы OData версии 3.0.

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

-ObjectId

Указывает идентификатор (в виде имени участника-пользователя или ObjectId) пользователя в Microsoft Entra ID.

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

-SearchString

Задает строку поиска.

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

-Top

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

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

Примечания

См. руководство по миграции get-AzureADUser в Microsoft Graph PowerShell.