Get-EntraUserAdministrativeUnit

Модуль:
Microsoft.Entra.Users Module v1.3

Извлекает список административных единиц, к которому принадлежит пользователь.

Синтаксис

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

Get-EntraUserAdministrativeUnit

    -UserId <String>
    [-All]
    [-Top <Int32>]
    [-Property <String[]>]
    [-Filter <String>]
    [<CommonParameters>]

GetById 

Get-EntraUserAdministrativeUnit

    -UserId <String>
    -AdministrativeUnitId <String>
    [-Property <String[]>]
    [<CommonParameters>]

Описание

Командлет Get-EntraUserAdministrativeUnit получает список административных единиц, к которым принадлежит пользователь.

Примеры

Пример 1. Получение списка административных единиц, к которым принадлежит конкретный пользователь

Connect-Entra -Scopes 'AdministrativeUnit.Read.All'
Get-EntraUserAdministrativeUnit -UserId 'SawyerM@contoso.com'

DeletedDateTime Id                                   Description                            DisplayName             Visibility
--------------- --                                   -----------                            -----------             ----------
                dddddddd-3333-4444-5555-eeeeeeeeeeee Pacific Administrative Unit            Pacific Admin Unit
                aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb Engineering Administrative Unit        Engineering Admin Unit

Этот командлет извлекает список административных единиц, к которым принадлежит конкретный пользователь.

Пример 2. Получение списка административных единиц, к которым принадлежит конкретный пользователь с помощью параметра All

Connect-Entra -Scopes 'AdministrativeUnit.Read.All'
Get-EntraUserAdministrativeUnit -UserId 'SawyerM@contoso.com' -All

DeletedDateTime Id                                   Description                            DisplayName             Visibility
--------------- --                                   -----------                            -----------             ----------
                dddddddd-3333-4444-5555-eeeeeeeeeeee Pacific Administrative Unit            Pacific Admin Unit
                aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb Engineering Administrative Unit        Engineering Admin Unit

Этот командлет извлекает список административных единиц, к которым принадлежит конкретный пользователь с помощью параметра All.

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

Connect-Entra -Scopes 'AdministrativeUnit.Read.All'
Get-EntraUserAdministrativeUnit -UserId 'SawyerM@contoso.com' -Top 1

DeletedDateTime Id                                   Description                            DisplayName             Visibility
--------------- --                                   -----------                            -----------             ----------
                dddddddd-3333-4444-5555-eeeeeeeeeeee Pacific Administrative Unit            Pacific Admin Unit

Этот командлет извлекает административную единицу, к которой принадлежит конкретный пользователь. Вы можете использовать -Limit в качестве псевдонима для -Top.

Пример 4. Получение списка административных единиц, к которым принадлежит конкретный пользователь с помощью параметра идентификатора административной единицы

Connect-Entra -Scopes 'AdministrativeUnit.Read.All'
$administrativeUnit = Get-EntraAdministrativeUnit -Filter "DisplayName eq 'Pacific Admin Unit'"
Get-EntraUserAdministrativeUnit -UserId 'SawyerM@contoso.com' -AdministrativeUnitId $administrativeUnit.Id

DeletedDateTime Id                                   Description                            DisplayName             Visibility
--------------- --                                   -----------                            -----------             ----------
                dddddddd-3333-4444-5555-eeeeeeeeeeee Pacific Administrative Unit            Pacific Admin Unit

Этот командлет извлекает список административных единиц, к которым принадлежит конкретный пользователь с помощью параметра идентификатора административной единицы.

  • -AdministrativeUnitId параметр задает идентификатор административной единицы.

Пример 5. Получение административной единицы, к которой принадлежит конкретный пользователь

Connect-Entra -Scopes 'AdministrativeUnit.Read.All'
Get-EntraUserAdministrativeUnit -UserId 'SawyerM@contoso.com' -Filter "Id eq 'dddddddd-3333-4444-5555-eeeeeeeeeeee'"

DeletedDateTime Id                                   Description                            DisplayName             Visibility
--------------- --                                   -----------                            -----------             ----------
                dddddddd-3333-4444-5555-eeeeeeeeeeee Pacific Administrative Unit            Pacific Admin Unit

Этот командлет извлекает административную единицу, к которой принадлежит конкретный пользователь.

Параметры

-AdministrativeUnitId

Уникальный идентификатор административной единицы.

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

Тип:System.String
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:DirectoryObjectId

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

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

-All

Вывод списка всех страниц.

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

Тип:System.Management.Automation.SwitchParameter
Значение по умолчанию:False
Поддерживаются подстановочные знаки:False
DontShow:False

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

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

-Filter

Указывает инструкцию фильтра OData версии 4.0. Этот параметр определяет, какие объекты возвращаются.

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

Тип:System.String
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

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

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

-Property

Указывает свойства, возвращаемые

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

Тип:

System.String[]

Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:Select

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

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

-Top

Максимальное количество административных единиц, к которым принадлежит пользователь.

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

Тип:System.Int32
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:Ограничение

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

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

-UserId

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

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

Тип:System.String
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:ObjectId (идентификатор объекта), UPN, Identity, ОсновноеИмяПользователя

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

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

CommonParameters

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

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

System.Object