Get-AzADGroup

Referência

Módulo:: Az.Resources

Lista entidades de grupos ou obtém entidade de grupos por chave

Syntax

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>]

Description

Lista entidades de grupos ou obtém entidade de grupos por chave

Exemplos

Exemplo 1: Obter grupo por nome de exibição

Get-AzADGroup -DisplayName $gname

Obter grupo por nome de exibição

Exemplo 2: listar grupos

Get-AzADGroup -First 10

Listar os primeiros 10 grupos

Exemplo 3: Obter grupo por ID de objeto

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

Obtenha grupo por ID de objeto e acrescente a propriedade 'groupTypes' após as propriedades padrão: 'DisplayName', 'Id', 'DeletedDateTime', 'SecurityEnabled', 'MailEnabled', 'MailNickname', 'Description'

Exemplo 4: Obter grupo com filtro

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

Obter grupo com filtro

Exemplo 5: Atribuir OdataCount a uma variável

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

Atribuir OdataCount a uma variável

Parâmetros

-AppendSelected

Anexar propriedades selecionadas com propriedades padrão quando essa opção está ativada, só funciona com o parâmetro '-Select'.

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

-ConsistencyLevel

Indica o nível de consistência solicitado. URL da documentação: 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
Accept pipeline input:	False
Accept wildcard characters:	False

-Count

Incluir contagem de itens

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

-CountVariable

Especifica uma contagem do número total de itens em uma coleção. Por padrão, essa variável será definida no escopo global.

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

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para a comunicação com o Azure.

Type:	PSObject
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DisplayName

O nome para exibição do grupo.

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

-DisplayNameStartsWith

Usado para localizar grupos que começam com a cadeia de caracteres fornecida.

Type:	String
Aliases:	SearchString
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Expand

Expandir entidades relacionadas

Type:	String[]
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Filter

Filtre itens por valores de propriedade. Para obter mais detalhes sobre a consulta de filtro, confira: https://learn.microsoft.com/en-us/graph/filter-query-parameter

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

-First

Obtém apenas os primeiros objetos 'n'.

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

-ObjectId

key: id do grupo

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

-Orderby

Ordenar itens por valores de propriedade

Type:	String[]
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Search

Pesquisar itens por frases de pesquisa

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

-Select

Selecione as propriedades a serem retornadas

Type:	String[]
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Skip

Ignora os primeiros objetos 'n' e, em seguida, obtém os objetos restantes.

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

Saídas

IMicrosoftGraphGroup

Observações

ALIASES