Bagikan melalui


Get-AzADGroup

Mencantumkan entitas dari grup atau mendapatkan entitas dari grup menurut kunci

Sintaks

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

Deskripsi

Mencantumkan entitas dari grup atau mendapatkan entitas dari grup menurut kunci

Contoh

Contoh 1: Dapatkan grup menurut nama tampilan

Get-AzADGroup -DisplayName $gname

Dapatkan grup menurut nama tampilan

Contoh 2: Mencantumkan grup

Get-AzADGroup -First 10

Mencantumkan 10 grup pertama

Contoh 3: Dapatkan grup menurut id objek

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

Dapatkan grup menurut id objek dan tambahkan properti 'groupTypes' setelah properti default: 'DisplayName', 'Id', 'DeletedDateTime', 'SecurityEnabled', 'MailEnabled', 'MailNickname', 'Description'

Contoh 4: Dapatkan grup dengan filter

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

Mendapatkan grup dengan filter

Contoh 5: Menetapkan OdataCount ke variabel

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

Menetapkan OdataCount ke variabel

Parameter

-AppendSelected

Tambahkan properti yang dipilih dengan properti default saat sakelar ini aktif, hanya berfungsi dengan parameter '-Select'.

Jenis:SwitchParameter
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-ConsistencyLevel

Menunjukkan tingkat konsistensi yang diminta. URL Dokumentasi: https://developer.microsoft.com/en-us/office/blogs/microsoft-graph-advanced-queries-for-directory-objects-are-now-generally-available/

Jenis:String
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-Count

Sertakan jumlah item

Jenis:SwitchParameter
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-CountVariable

Menentukan hitungan jumlah total item dalam koleksi. Secara default, variabel ini akan diatur dalam cakupan global.

Jenis:String
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-DefaultProfile

Kredensial, akun, penyewa, dan langganan yang digunakan untuk komunikasi dengan Azure.

Jenis:PSObject
Alias:AzContext, AzureRmContext, AzureCredential
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-DisplayName

Nama tampilan grup.

Jenis:String
Position:Named
Nilai default:None
Diperlukan:True
Terima input alur:False
Terima karakter wildcard:False

-DisplayNameStartsWith

Digunakan untuk menemukan grup yang dimulai dengan string yang disediakan.

Jenis:String
Alias:SearchString
Position:Named
Nilai default:None
Diperlukan:True
Terima input alur:False
Terima karakter wildcard:False

-Expand

Perluas entitas terkait

Jenis:String[]
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-Filter

Filter item menurut nilai properti, untuk detail selengkapnya tentang kueri filter, silakan lihat: https://learn.microsoft.com/en-us/graph/filter-query-parameter

Jenis:String
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-First

Hanya mendapatkan objek 'n' pertama.

Jenis:UInt64
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-ObjectId

kunci: id grup

Jenis:Guid
Position:Named
Nilai default:None
Diperlukan:True
Terima input alur:False
Terima karakter wildcard:False

-Orderby

Mengurutkan item menurut nilai properti

Jenis:String[]
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

Mencari item menurut frasa pencarian

Jenis:String
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-Select

Pilih properti yang akan dikembalikan

Jenis:String[]
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-Skip

Mengabaikan objek 'n' pertama lalu mendapatkan objek yang tersisa.

Jenis:UInt64
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

Output

IMicrosoftGraphGroup

Catatan

ALIAS