Dela via


Get-AzADGroup

Visar entiteter från grupper eller hämta entiteter från grupper efter nyckel

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

Visar entiteter från grupper eller hämta entiteter från grupper efter nyckel

Exempel

Exempel 1: Hämta grupp efter visningsnamn

Get-AzADGroup -DisplayName $gname

Hämta grupp efter visningsnamn

Exempel 2: Lista grupper

Get-AzADGroup -First 10

Lista de första 10 grupperna

Exempel 3: Hämta grupp efter objekt-ID

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

Hämta grupp efter objekt-ID och tilläggsegenskapen "groupTypes" efter standardegenskaperna: "DisplayName", "Id", "DeletedDateTime", "SecurityEnabled", "MailEnabled", "MailNickname", "Description"

Exempel 4: Hämta grupp med filter

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

Hämta grupp med filter

Exempel 5: Tilldela OdataCount till en variabel

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

Tilldela OdataCount till en variabel

Parametrar

-AppendSelected

Tilläggsegenskaper som valts med standardegenskaper när den här växeln är på fungerar bara med parametern "-Select".

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ConsistencyLevel

Anger den begärda konsekvensnivån. Dokumentations-URL: https://developer.microsoft.com/en-us/office/blogs/microsoft-graph-advanced-queries-for-directory-objects-are-now-generally-available/

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Count

Inkludera antal objekt

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-CountVariable

Anger antalet objekt i en samling. Som standard anges den här variabeln i det globala omfånget.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.

Typ:PSObject
Alias:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DisplayName

Visningsnamnet för gruppen.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DisplayNameStartsWith

Används för att hitta grupper som börjar med den angivna strängen.

Typ:String
Alias:SearchString
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Expand

Expandera relaterade entiteter

Typ:String[]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Filter

Filtrera objekt efter egenskapsvärden för mer information om filterfrågan i: https://learn.microsoft.com/en-us/graph/filter-query-parameter

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-First

Hämtar bara de första n-objekten.

Typ:UInt64
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ObjectId

nyckel: ID för grupp

Typ:Guid
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Orderby

Sortera objekt efter egenskapsvärden

Typ:String[]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Sök efter sökfraser

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Select

Välj egenskaper som ska returneras

Typ:String[]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Skip

Ignorerar de första n-objekten och hämtar sedan de återstående objekten.

Typ:UInt64
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Utdata

IMicrosoftGraphGroup

Kommentarer

ALIAS