Condividi tramite

New-AzureADMSGroup

  • Riferimento
Modulo:
AzureAD

Crea un gruppo di Azure AD.

Sintassi

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

Descrizione

Il cmdlet New-AzureADMSGroup crea un gruppo di Azure Active Directory (Azure AD).

Esempio

Esempio: creare un gruppo assegnabile al ruolo

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                    : {}

Parametri

-Description

Specifica una descrizione per il gruppo.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DisplayName

Specifica un nome visualizzato per il gruppo.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-GroupTypes

Specifica che il gruppo è un gruppo unificato o dinamico.

Note:

  • Questo parametro attualmente non può essere usato per creare gruppi dinamici. Per creare un gruppo dinamico in PowerShell, è necessario usare il modulo Di anteprima di Azure AD.
Tipo:List<T>[String]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-IsAssignableToRole

Indica se è possibile assegnare un gruppo a un ruolo. Questa proprietà può essere impostata solo al momento della creazione del gruppo e non può essere modificata in un gruppo esistente.

Tipo:Boolean
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-MailEnabled

Indica se il gruppo è abilitato per la posta elettronica.

Attualmente non è possibile creare gruppi abilitati alla posta in Azure AD.

Tipo:Boolean
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-MailNickname

Specifica un nome alternativo di posta elettronica per il gruppo. Se MailEnabled è $False è comunque necessario specificare un soprannome di posta elettronica.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-SecurityEnabled

Indica se il gruppo è abilitato per la sicurezza. Per i gruppi di sicurezza, questo valore deve essere $True.

Tipo:Boolean
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Visibility

Specifica la visibilità dell'elenco di contenuti e membri del gruppo. Questo parametro può accettare uno dei valori seguenti:

  • "Pubblico" - Chiunque può visualizzare il contenuto del gruppo
  • "Privato" - Solo i membri possono visualizzare il contenuto del gruppo
  • "HiddenMembership": solo i membri possono visualizzare il contenuto del gruppo e solo i membri, i proprietari, l'amministratore globale/aziendale, l'amministratore utenti e gli amministratori del supporto tecnico possono visualizzare l'elenco dei membri del gruppo.

Se non viene specificato alcun valore, il valore predefinito sarà "Public".

Note:

  • Questo parametro è valido solo per i gruppi con groupType impostato su "Unified".
  • Se un gruppo ha questo attributo impostato su "HiddenMembership" non può essere modificato in un secondo momento.
  • Chiunque può partecipare a un gruppo con questo attributo impostato su "Public". Se l'attributo è impostato su Private o HiddenMembership, solo i proprietari possono aggiungere nuovi membri al gruppo e le richieste per l'aggiunta al gruppo necessitano dell'approvazione dei proprietari.
Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

None

Output

Object

Note

Vedere la guida alla migrazione per New-AzureADMSGroup in Microsoft Graph PowerShell.

Questo cmdlet è attualmente disponibile in anteprima pubblica. Anche se un cmdlet è in anteprima pubblica, è possibile apportare modifiche al cmdlet che potrebbero avere effetti imprevisti. È consigliabile non usare questo cmdlet in un ambiente di produzione.