Get-AzADGroup

Reference

Modul:: Az.Resources

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

Syntaxe

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.

Typ:	SwitchParameter
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	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/

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Count

Zahrnout počet položek

Typ:	SwitchParameter
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	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.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-DefaultProfile

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

Typ:	PSObject
Aliasy:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-DisplayName

Zobrazovaný název skupiny.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-DisplayNameStartsWith

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

Typ:	String
Aliasy:	SearchString
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Expand

Rozbalení souvisejících entit

Typ:	String[]
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	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

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-First

Získá pouze první n objekty.

Typ:	UInt64
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-ObjectId

key: ID skupiny

Typ:	Guid
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Orderby

Pořadí položek podle hodnot vlastností

Typ:	String[]
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Search

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

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Select

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

Typ:	String[]
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Skip

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

Typ:	UInt64
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

Výstupy

IMicrosoftGraphGroup

Poznámky

ALIASY

Sdílet prostřednictvím