Get-AzADUser
Перечисление сущностей от пользователей или получение сущностей от пользователей по ключу
Синтаксис
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.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ConsistencyLevel
Указывает запрошенный уровень согласованности. URL-адрес документации: https://developer.microsoft.com/en-us/office/blogs/microsoft-graph-advanced-queries-for-directory-objects-are-now-generally-available/
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Count
Включение количества элементов
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CountVariable
Указывает количество общих элементов в коллекции. По умолчанию эта переменная будет задана в глобальном область.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DefaultProfile
Учетные данные, учетная запись, клиент и подписка, используемые для взаимодействия с Azure.
Type: | PSObject |
Aliases: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisplayName
отображаемое имя пользователя
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Expand
Разверните связанные сущности
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Filter
Дополнительные сведения о запросе фильтра см. в разделе "Фильтрация элементов по значениям свойств" https://learn.microsoft.com/en-us/graph/filter-query-parameter
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-First
Возвращает только первые объекты n.
Type: | UInt64 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
адрес электронной почты пользователя
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ObjectId
ключ: идентификатор пользователя
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Orderby
Упорядочивание элементов по значениям свойств
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Search
Поиск элементов по фразам поиска
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Select
Выбор свойств для возврата
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SignedIn
адрес электронной почты пользователя
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Skip
Игнорирует первые объекты n, а затем получает оставшиеся объекты.
Type: | UInt64 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-StartsWith
отображаемое имя пользователя начинается с
Type: | String |
Aliases: | SearchString |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UserPrincipalName
Имя участника-пользователя.
Type: | String |
Aliases: | UPN |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Выходные данные
Примечания
ПСЕВДОНИМЫ
Azure PowerShell
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по