Share via

New-AzureADMSGroup

  • Referensi
Modul:
AzureAD

Membuat grup Azure AD.

Sintaks

New-AzureADMSGroup
   [-Description <String>]
   -DisplayName <String>
   [-IsAssignableToRole <Boolean>]
   -MailEnabled <Boolean>
   -MailNickname <String>
   -SecurityEnabled <Boolean>
   [-GroupTypes <System.Collections.Generic.List`1[System.String]>]
   [-Visibility <String>]
   [<CommonParameters>]

Deskripsi

Cmdlet New-AzureADMSGroup membuat grup Azure Active Directory (Azure AD).

Contoh

Contoh : Membuat grup yang dapat ditetapkan ke peran

PS C:\> New-AzureADMSGroup -DisplayName "HelpDesk admin group" -Description "Group assignable to role" -MailEnabled $False -MailNickname "helpDeskAdminGroup" -SecurityEnabled $True -IsAssignableToRole $True -Visibility "Private"

Id                            : 1026185e-25df-4522-a380-7ab697a7241c
Description                   : Group assignable to role
OnPremisesSyncEnabled         : 
DisplayName                   : HelpDesk admin group
Mail                          : 
MailEnabled                   : False
IsAssignableToRole            : True 
MailNickname                  : helpDeskAdminGroup
ProxyAddresses                : {} 
SecurityEnabled               : True 
GroupTypes                    : {}

Parameter

-Description

Menentukan deskripsi untuk grup.

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

-DisplayName

Menentukan nama tampilan untuk grup.

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

-GroupTypes

Menentukan bahwa grup adalah grup terpadu atau dinamis.

Catatan:

  • Parameter ini saat ini tidak dapat digunakan untuk membuat grup dinamis. Untuk membuat grup dinamis di PowerShell, Anda harus menggunakan modul Pratinjau Azure AD.
Type:List<T>[String]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IsAssignableToRole

Menunjukkan apakah grup dapat ditetapkan ke peran. Properti ini hanya dapat diatur pada saat pembuatan grup dan tidak dapat dimodifikasi pada grup yang ada.

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

-MailEnabled

Menunjukkan apakah grup ini diaktifkan email.

Saat ini, Anda tidak dapat membuat grup yang diaktifkan email dalam Azure AD.

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

-MailNickname

Menentukan nama panggilan surat untuk grup. Jika MailEnabled $False Anda masih harus menentukan nama panggilan email.

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

-SecurityEnabled

Menunjukkan apakah grup diaktifkan keamanan. Untuk grup keamanan, nilai ini harus $True.

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

-Visibility

Menentukan visibilitas konten grup dan daftar anggota. Parameter ini dapat mengambil salah satu nilai berikut:

  • "Publik" - Siapa pun dapat melihat konten grup
  • "Privat" - Hanya anggota yang dapat melihat konten grup
  • "HiddenMembership" - Hanya anggota yang dapat melihat konten grup dan hanya anggota, pemilik, Administrator Global/Perusahaan, Administrator Pengguna, dan Administrator Bantuan Teknis yang dapat melihat daftar anggota grup.

Jika tidak ada nilai yang disediakan, nilai defaultnya adalah "Publik".

Catatan:

  • Parameter ini hanya valid untuk grup yang memiliki groupType yang diatur ke "Unified".
  • Jika grup memiliki atribut ini yang diatur ke "HiddenMembership" itu tidak dapat diubah nanti.
  • Siapa pun dapat bergabung dengan grup yang memiliki atribut ini diatur ke "Publik". Jika atribut diatur ke Privat atau HiddenMembership, hanya pemilik yang dapat menambahkan anggota baru ke grup dan permintaan untuk bergabung dengan grup memerlukan persetujuan pemilik.
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Input

None

Output

Object

Catatan

Lihat panduan migrasi untuk New-AzureADMSGroup ke Microsoft Graph PowerShell.

Cmdlet ini saat ini dalam Pratinjau Umum. Saat cmdlet berada di Pratinjau Umum, kami dapat membuat perubahan pada cmdlet yang dapat memiliki efek yang tidak terduga. Kami menyarankan agar Anda tidak menggunakan cmdlet ini di lingkungan produksi.