Прочитать на английском

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

Get-AzADUser

  • Ссылка
Модуль:
Az.Resources

Перечисление сущностей от пользователей или получение сущностей от пользователей по ключу

Синтаксис

Get-AzADUser
   [-Count]
   [-Expand <String[]>]
   [-Select <String[]>]
   [-First <UInt64>]
   [-Skip <UInt64>]
   [-AppendSelected]
   [-Filter <String>]
   [-Orderby <String[]>]
   [-Search <String>]
   [-ConsistencyLevel <String>]
   [-DefaultProfile <PSObject>]
   [-CountVariable <String>]
   [<CommonParameters>]
Get-AzADUser
   [-Expand <String[]>]
   [-Select <String[]>]
   [-First <UInt64>]
   [-Skip <UInt64>]
   [-AppendSelected]
   [-DefaultProfile <PSObject>]
   -Mail <String>
   [<CommonParameters>]
Get-AzADUser
   [-Expand <String[]>]
   [-Select <String[]>]
   [-First <UInt64>]
   [-Skip <UInt64>]
   [-AppendSelected]
   [-DefaultProfile <PSObject>]
   -DisplayName <String>
   [<CommonParameters>]
Get-AzADUser
   [-Expand <String[]>]
   [-Select <String[]>]
   [-First <UInt64>]
   [-Skip <UInt64>]
   [-AppendSelected]
   [-DefaultProfile <PSObject>]
   -StartsWith <String>
   [<CommonParameters>]
Get-AzADUser
   [-Expand <String[]>]
   [-Select <String[]>]
   [-AppendSelected]
   [-DefaultProfile <PSObject>]
   -ObjectId <String>
   [<CommonParameters>]
Get-AzADUser
   [-Expand <String[]>]
   [-Select <String[]>]
   [-AppendSelected]
   [-DefaultProfile <PSObject>]
   -UserPrincipalName <String>
   [<CommonParameters>]
Get-AzADUser
   [-Expand <String[]>]
   [-Select <String[]>]
   [-AppendSelected]
   [-DefaultProfile <PSObject>]
   [-SignedIn]
   [<CommonParameters>]

Описание

Перечисление сущностей от пользователей или получение сущностей от пользователей по ключу

Примеры

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

Get-AzADUser -SignedIn

Получение пользователя входа

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

Get-AzADUser -First 10 -Select 'City' -AppendSelected

Список первых 10 пользователей и добавление свойства "City" после свойств по умолчанию: DisplayName, "Id", "DeletedDateTime", "UserPrincipalName", "UsageLocation", "GivenName", "SurName", "AccountEnabled", "MailNickName", "MailNickName"

Пример 3. Получение пользователя по отображаемого имени

Get-AzADUser -DisplayName $name

Получение пользователя по отображаемого имени

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

Get-AzADUser -Filter "startsWith(DisplayName,'some-name')"

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

Пример 5. Назначение OdataCount переменной

Get-AzADUser -First 10 -ConsistencyLevel eventual -Count -CountVariable 'result'
$result

Назначение OdataCount переменной

Параметры

-AppendSelected

Добавление свойств, выбранных с помощью свойств по умолчанию при включении этого переключателя, работает только с параметром -Select.

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

-ConsistencyLevel

Указывает запрошенный уровень согласованности. URL-адрес документации: https://developer.microsoft.com/en-us/office/blogs/microsoft-graph-advanced-queries-for-directory-objects-are-now-generally-available/

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

-Count

Включение количества элементов

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

-CountVariable

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

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

-DefaultProfile

Учетные данные, учетная запись, клиент и подписка, используемые для взаимодействия с Azure.

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

-DisplayName

отображаемое имя пользователя

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

-Expand

Разверните связанные сущности

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

-Filter

Фильтрация элементов по значениям свойств, дополнительные сведения о запросе фильтра см. в статье https://learn.microsoft.com/en-us/graph/filter-query-parameter

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

-First

Возвращает только первые объекты n.

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

-Mail

адрес электронной почты пользователя

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

-ObjectId

ключ: идентификатор пользователя

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

-Orderby

Упорядочивание элементов по значениям свойств

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

-Search

Поиск элементов по фразам поиска

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

-Select

Выбор свойств для возврата

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

-SignedIn

адрес электронной почты пользователя

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

-Skip

Игнорирует первые объекты n, а затем получает оставшиеся объекты.

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

-StartsWith

отображаемое имя пользователя начинается с

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

-UserPrincipalName

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

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

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

IMicrosoftGraphUser