Get-AzADGroup

Ссылка

Модуль:: Az.Resources

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

Синтаксис

Get-AzADGroup
   [-Count]
   [-Expand <String[]>]
   [-Select <String[]>]
   [-Filter <String>]
   [-Orderby <String[]>]
   [-Search <String>]
   [-ConsistencyLevel <String>]
   [-First <UInt64>]
   [-Skip <UInt64>]
   [-AppendSelected]
   [-DefaultProfile <PSObject>]
   [-CountVariable <String>]
   [<CommonParameters>]

Get-AzADGroup
   [-Expand <String[]>]
   [-Select <String[]>]
   [-ConsistencyLevel <String>]
   [-First <UInt64>]
   [-Skip <UInt64>]
   [-AppendSelected]
   -DisplayName <String>
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

Get-AzADGroup
   [-Expand <String[]>]
   [-Select <String[]>]
   [-ConsistencyLevel <String>]
   [-First <UInt64>]
   [-Skip <UInt64>]
   [-AppendSelected]
   -DisplayNameStartsWith <String>
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

Get-AzADGroup
   [-Expand <String[]>]
   [-Select <String[]>]
   [-ConsistencyLevel <String>]
   [-AppendSelected]
   -ObjectId <Guid>
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

Описание

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

Примеры

Пример 1. Получение группы по отображаемого имени

Get-AzADGroup -DisplayName $gname

Получение группы по отображаемого имени

Пример 2. Список групп

Get-AzADGroup -First 10

Список первых 10 групп

Пример 3. Получение группы по идентификатору объекта

Get-AzADGroup -ObjectId $id -Select groupTypes -AppendSelected

Получение группы по идентификатору объекта и свойству add "groupTypes" после свойств по умолчанию: DisplayName, "Id", "DeletedDateTime", "SecurityEnabled", "MailEnabled", "MailNickname", "Description"

Пример 4. Получение группы с фильтром

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

Получение группы с фильтром

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

Get-AzADGroup -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

-DisplayNameStartsWith

Используется для поиска групп, начинающихся с предоставленной строки.

Type:	String
Aliases:	SearchString
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

-ObjectId

ключ: идентификатор группы

Type:	Guid
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

-Skip

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

Type:	UInt64
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

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

IMicrosoftGraphGroup

Примечания

ПСЕВДОНИМЫ