Get-AzADGroup

Enumera las entidades de grupos o obtiene entidades de grupos por clave.

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

Enumera las entidades de grupos o obtiene entidades de grupos por clave.

Ejemplos

Ejemplo 1: Obtener grupo por nombre para mostrar

Get-AzADGroup -DisplayName $gname

Obtener grupo por nombre para mostrar

Ejemplo 2: Enumerar grupos

Get-AzADGroup -First 10

Enumerar los primeros 10 grupos

Ejemplo 3: Obtención del grupo por identificador de objeto

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

Obtiene group by object id y append property 'groupTypes' después de las propiedades predeterminadas: 'DisplayName', 'Id', 'DeletedDateTime', 'SecurityEnabled', 'MailEnabled', 'MailNickname', 'Description'

Ejemplo 4: Obtener grupo con filtro

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

Obtener grupo con filtro

Ejemplo 5: Asignación de OdataCount a una variable

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

Asignación de OdataCount a una variable

Parámetros

-AppendSelected

Anexar propiedades seleccionadas con propiedades predeterminadas cuando este modificador está activado, solo funciona con el parámetro "-Select".

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

-ConsistencyLevel

Indica el nivel de coherencia solicitado. Dirección URL de documentación: 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

Incluir recuento de elementos

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

-CountVariable

Especifica un recuento del número total de elementos de una colección. De forma predeterminada, esta variable se establecerá en el ámbito global.

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

-DefaultProfile

Credenciales, cuenta, inquilino y suscripción usados para la comunicación con Azure.

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

-DisplayName

Nombre para mostrar del grupo.

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

-DisplayNameStartsWith

Se usa para buscar grupos que comienzan con la cadena proporcionada.

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

-Expand

Expansión de entidades relacionadas

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

-Filter

Filtre los elementos por valores de propiedad para obtener más detalles sobre la consulta de filtro, consulte: 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

Obtiene solo los primeros objetos 'n'.

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

-ObjectId

key: id. de grupo

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

-Orderby

Ordenar elementos por valores de propiedad

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

Buscar elementos por frases de búsqueda

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

-Select

Selección de propiedades que se van a devolver

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

-Skip

Omite los primeros objetos 'n' y, a continuación, obtiene los objetos restantes.

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

Salidas

IMicrosoftGraphGroup

Notas

ALIAS