Get-AzADGroup

Modul:

Az.Resources Module

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

Syntax

EmptyParameterSet (Výchozí)

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

DisplayNameParameterSet

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

SearchStringParameterSet

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

ObjectIdParameterSet

Get-AzADGroup
    -ObjectId <Guid>
    [-Expand <String[]>]
    [-Select <String[]>]
    [-ConsistencyLevel <String>]
    [-AppendSelected]
    [-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.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	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/

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Count

Zahrnout počet položek

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

EmptyParameterSet

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	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.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

EmptyParameterSet

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-DefaultProfile

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

Vlastnosti parametru

Typ:	PSObject
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	AzContext, AzureRmContext, AzureCredential

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-DisplayName

Zobrazovaný název skupiny

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

DisplayNameParameterSet

Position:	Named
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-DisplayNameStartsWith

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

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	SearchString

Sady parametrů

SearchStringParameterSet

Position:	Named
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Expand

Rozbalení souvisejících entit

Vlastnosti parametru

Typ:	String[]
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	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

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

EmptyParameterSet

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-First

Získá pouze první n objekty.

Vlastnosti parametru

Typ:	UInt64
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

EmptyParameterSet

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

DisplayNameParameterSet

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

SearchStringParameterSet

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-ObjectId

key: ID skupiny

Vlastnosti parametru

Typ:	Guid
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

ObjectIdParameterSet

Position:	Named
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Orderby

Pořadí položek podle hodnot vlastností

Vlastnosti parametru

Typ:	String[]
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

EmptyParameterSet

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Search

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

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

EmptyParameterSet

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Select

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

Vlastnosti parametru

Typ:	String[]
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Skip

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

Vlastnosti parametru

Typ:	UInt64
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

EmptyParameterSet

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

DisplayNameParameterSet

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

SearchStringParameterSet

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

CommonParameters

Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.

Výstupy

IMicrosoftGraphGroup