Share via

Get-MsolGroup

  • Referensi
Modul:
MSOnline

Mendapatkan grup dari Azure Active Directory.

Sintaks

Get-MsolGroup
   [-UserObjectId <Guid>]
   [-IsAgentRole]
   [-UserPrincipalName <String>]
   [-GroupType <GroupType>]
   [-HasErrorsOnly]
   [-HasLicenseErrorsOnly <Boolean>]
   [-SearchString <String>]
   [-MaxResults <Int32>]
   [-TenantId <Guid>]
   [<CommonParameters>]
Get-MsolGroup
   -ObjectId <Guid>
   [-TenantId <Guid>]
   [<CommonParameters>]
Get-MsolGroup
   [-UserObjectId <Guid>]
   [-IsAgentRole]
   [-UserPrincipalName <String>]
   [-GroupType <GroupType>]
   [-HasErrorsOnly]
   [-HasLicenseErrorsOnly <Boolean>]
   [-SearchString <String>]
   [-All]
   [-TenantId <Guid>]
   [<CommonParameters>]

Deskripsi

Cmdlet Get-MsolGroup mendapatkan grup dari Azure Active Directory. Cmdlet ini dapat digunakan untuk mengembalikan satu grup, jika Anda menentukan parameter ObjectId , atau untuk mencari di dalam semua grup.

Contoh

Contoh 1: Mendapatkan grup dengan menggunakan ID

PS C:\> Get-MsolGroup -ObjectId af407072-7ae1-4b07-a0ca-6634b7396054

Perintah ini mengembalikan objek grup yang memiliki ID yang ditentukan.

Contoh 2: Dapatkan semua grup

PS C:\> Get-MsolGroup

Perintah ini mengembalikan seluruh set grup untuk penyewa, hingga 250 hasil default.

Contoh 3: Mendapatkan grup dengan menggunakan nama prinsipal pengguna

PS C:\> Get-MsolGroup -isAgentRole -UserPrincipalName "pattifuller@contoso.com"

Perintah ini mengembalikan grup agen tempat pengguna menjadi anggotanya. Ini hanya berlaku untuk perusahaan yang memiliki hak istimewa mitra.

Parameter

-All

Menunjukkan bahwa cmdlet ini mengembalikan semua hasil yang ditemukannya. Jangan tentukan parameter ini dan parameter MaxResults .

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

-GroupType

Menentukan jenis grup yang akan didapatkan. Nilai yang valid adalah Keamanan, MailEnabledSecurity, dan DistributionList.

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

-HasErrorsOnly

Menunjukkan bahwa cmdlet ini hanya mengembalikan grup yang memiliki kesalahan validasi.

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

-HasLicenseErrorsOnly

Menentukan apakah cmdlet ini hanya mengembalikan grup keamanan yang memiliki kesalahan lisensi.

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

-IsAgentRole

Menentukan bahwa cmdlet ini hanya mengembalikan grup agen. Nilai ini hanya berlaku untuk pengguna mitra.

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

-MaxResults

Menentukan jumlah maksimum hasil yang dikembalikan cmdlet ini. Nilai defaultnya adalah 250.

Type:Int32
Position:Named
Default value:250
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ObjectId

Menentukan ID objek unik grup yang akan didapatkan.

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

-SearchString

Menentukan string. Cmdlet ini mengembalikan grup keamanan yang memiliki nama tampilan yang dimulai dengan string ini.

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

-TenantId

Menentukan ID unik penyewa untuk melakukan operasi. Nilai default adalah penyewa pengguna saat ini. Parameter ini hanya berlaku untuk pengguna mitra.

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

-UserObjectId

Menentukan ID unik pengguna. Cmdlet ini mengembalikan grup keamanan tempat pengguna ini berada. Parameter ini harus digunakan bersama dengan parameter IsAgentRole .

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

-UserPrincipalName

Menentukan nama utama pengguna pengguna. Cmdlet ini mengembalikan grup keamanan tempat pengguna ini berada. Parameter ini harus digunakan bersama dengan parameter IsAgentRole .

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

Output

Microsoft.Online.Administration.Group

Cmdlet ini mengembalikan daftar grup, yang mencakup informasi berikut:

  • CommonName. Nama umum grup.

  • Keterangan. Deskripsi grup.

  • Displayname. Nama tampilan grup.

  • Emailaddress. Alamat email grup. Ini tidak dikembalikan untuk grup keamanan.

  • Kesalahan. Daftar kesalahan untuk grup.

  • GroupType. Jenis grup. Jenis dapat berupa SecurityGroup, DistributionList atau MailEnabledSecurityGroup.

  • IsSystem. Apakah grup ini adalah grup sistem (dibuat oleh Azure Active Directory atau tidak). Grup ini tidak dapat diperbarui atau dihapus.

  • LastDirSyncTime. Tanggal dan waktu grup terakhir disinkronkan.

  • ManagedBy. Pemilik grup.

  • ObjectId. ID objek unik grup.

  • Alamat Proksi. Alamat proksi yang terkait dengan grup ini (hanya untuk grup yang mendukung email).

  • ValidationStatus. Apakah grup memiliki kesalahan atau tidak.