Get-AzADGroup

Odwołanie

Moduł:: Az.Resources

Wyświetla listę jednostek z grup lub pobieranie jednostki z grup według klucza

Składnia

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

Opis

Wyświetla listę jednostek z grup lub pobieranie jednostki z grup według klucza

Przykłady

Przykład 1. Pobieranie grupy według nazwy wyświetlanej

Get-AzADGroup -DisplayName $gname

Pobieranie grupy według nazwy wyświetlanej

Przykład 2. Wyświetlanie listy grup

Get-AzADGroup -First 10

Lista pierwszych 10 grup

Przykład 3. Pobieranie grupy według identyfikatora obiektu

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

Pobierz grupę według identyfikatora obiektu i dołącz właściwość "groupTypes" po właściwościach domyślnych: "DisplayName", "Id", "DeletedDateTime", "SecurityEnabled", "MailEnabled", "MailNickname", "Description"

Przykład 4. Pobieranie grupy z filtrem

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

Pobieranie grupy z filtrem

Przykład 5. Przypisywanie zmiennej OdataCount do zmiennej

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

Przypisywanie wartości OdataCount do zmiennej

Parametry

-AppendSelected

Dołącz właściwości wybrane z właściwościami domyślnymi, gdy ten przełącznik jest włączony, działa tylko z parametrem "-Select".

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

-ConsistencyLevel

Wskazuje żądany poziom spójności. Adres URL dokumentacji: 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

Uwzględnij liczbę elementów

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

-CountVariable

Określa liczbę całkowitej liczby elementów w kolekcji. Domyślnie ta zmienna zostanie ustawiona w zakresie globalnym.

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

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure.

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

-DisplayName

Nazwa wyświetlana grupy.

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

-DisplayNameStartsWith

Służy do znajdowania grup rozpoczynających się od podanego ciągu.

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

-Expand

Rozwijanie powiązanych jednostek

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

-Filter

Filtruj elementy według wartości właściwości, aby uzyskać więcej szczegółów na temat zapytania filtru, zobacz: 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

Pobiera tylko pierwsze obiekty "n".

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

-ObjectId

key: identyfikator grupy

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

-Orderby

Porządkowaj elementy według wartości właściwości

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

-Search

Wyszukiwanie elementów według fraz wyszukiwania

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

-Select

Wybierz właściwości, które mają zostać zwrócone

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

-Skip

Ignoruje pierwsze obiekty "n", a następnie pobiera pozostałe obiekty.

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

Dane wyjściowe

IMicrosoftGraphGroup

Uwagi

ALIASY

Share via