Get-AzADGroup

Vypíše entity ze skupin nebo získá entitu ze skupin podle klíče.

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

Vypíše entity ze skupin nebo získá entitu ze skupin podle klíče.

Příklady

Příklad 1: Získání skupiny podle zobrazovaného názvu

Get-AzADGroup -DisplayName $gname

Získání skupiny podle zobrazovaného názvu

Příklad 2: Skupiny seznamů

Get-AzADGroup -First 10

Seznam prvních 10 skupin

Příklad 3: Získání seskupení podle ID objektu

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

Získání skupiny podle ID objektu a vlastnost připojení groupTypes po výchozích vlastnostech: DisplayName, Id, DeletedDateTime, SecurityEnabled, MailEnabled, MailNickname, Description

Příklad 4: Získání skupiny s filtrem

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

Získání skupiny s filtrem

Příklad 5: Přiřazení OdataCount k proměnné

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

Přiřazení OdataCount k proměnné

Parametry

-AppendSelected

Připojte vlastnosti vybrané s výchozími vlastnostmi, pokud je tento přepínač zapnutý, funguje pouze s parametrem -Select.

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

-ConsistencyLevel

Označuje požadovanou úroveň konzistence. Adresa URL dokumentace: 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

Zahrnout počet položek

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

-CountVariable

Určuje počet celkového počtu položek v kolekci. Ve výchozím nastavení se tato proměnná nastaví v globálním oboru.

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

-DefaultProfile

Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure.

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

-DisplayName

Zobrazovaný název skupiny.

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

-DisplayNameStartsWith

Slouží k vyhledání skupin, které začínají zadaným řetězcem.

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

-Expand

Rozbalení souvisejících entit

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

-Filter

Filtrování položek podle hodnot vlastností, další podrobnosti o dotazu filtru najdete tady: 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

Získá pouze první n objekty.

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

-ObjectId

key: ID skupiny

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

-Orderby

Pořadí položek podle hodnot vlastností

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

Hledání položek podle vyhledávacích frází

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

-Select

Výběr vlastností, které se mají vrátit

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

-Skip

Ignoruje první n objekty a pak získá zbývající objekty.

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

Výstupy

IMicrosoftGraphGroup

Poznámky

ALIASY