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

Get-AzureADUser

Модуль:
AzureAD Module

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

Синтаксис

GetQuery (по умолчанию) 

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

GetVague 

Get-AzureADUser
    [-SearchString <String>]
    [-All <Boolean>]
    [<CommonParameters>]

GetById 

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
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:True
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-Filter

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

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

GetQuery
Position:Named
Обязательно:False
Значение из конвейера:True
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-ObjectId

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

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

GetById
Position:Named
Обязательно:True
Значение из конвейера:True
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-SearchString

Указывает строку поиска.

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

GetVague
Position:Named
Обязательно:False
Значение из конвейера:True
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-Top

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

Свойства параметра

Тип:Int32
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

GetQuery
Position:Named
Обязательно:False
Значение из конвейера:True
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.

Примечания

Ознакомьтесь с руководством по миграции Get-AzureADUser в Microsoft Graph PowerShell.