Bagikan melalui

New-AzureADMSGroup

  • Referensi
Modul:
AzureAD

Membuat grup Azure Active Directory.

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.

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

-DisplayName

Menentukan nama tampilan untuk grup.

Jenis:String
Position:Named
Nilai default:None
Diperlukan:True
Terima input alur:False
Terima karakter wildcard: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 Microsoft Azure AD.
Jenis:List<T>[String]
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard: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.

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

-MailEnabled

Menunjukkan apakah grup ini diaktifkan melalui surat.

Saat ini, Anda tidak dapat membuat grup yang diaktifkan email di Azure ACTIVE Directory.

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

-MailNickname

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

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

-SecurityEnabled

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

Jenis:Boolean
Position:Named
Nilai default:None
Diperlukan:True
Terima input alur:False
Terima karakter wildcard: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 Helpdesk 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" maka tidak dapat diubah nanti.
  • Siapa pun dapat bergabung dengan grup yang memiliki atribut ini diatur ke "Publik". Jika atribut diatur ke Private atau HiddenMembership, hanya pemilik yang dapat menambahkan anggota baru ke grup dan permintaan untuk bergabung dengan grup memerlukan persetujuan pemilik.
Jenis:String
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard: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 bisa memiliki efek tak terduga. Kami menyarankan agar Anda tidak menggunakan cmdlet ini di lingkungan produksi.