Condividi tramite

New-AzureADMSGroup

Modulo:
AzureAD Module

Crea un gruppo di Azure AD.

Sintassi

Default (impostazione predefinita). 

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.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-DisplayName

Specifica un nome visualizzato per il gruppo.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-GroupTypes

Specifica che il gruppo è un gruppo unificato o dinamico.

Note:

  • Questo parametro non può essere utilizzato per creare gruppi dinamici. Per creare un gruppo dinamico in PowerShell, è necessario usare il modulo di anteprima di Azure AD.

Proprietà dei parametri

Tipo:

List<T>[String]

Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-IsAssignableToRole

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

Proprietà dei parametri

Tipo:Boolean
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-MailEnabled

Indica se il gruppo è abilitato alla posta elettronica.

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

Proprietà dei parametri

Tipo:Boolean
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-MailNickname

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

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-SecurityEnabled

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

Proprietà dei parametri

Tipo:Boolean
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Visibility

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

  • "Pubblico" - Chiunque può visualizzare i contenuti 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 dell'helpdesk possono visualizzare l'elenco dei membri del gruppo.

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

Note:

  • Questo parametro è valido solo per i gruppi in cui groupType è impostato su "Unified".
  • Se questo attributo di un gruppo è impostato su "HiddenMembership", non può essere modificato in un secondo momento.
  • Chiunque può unirsi a un gruppo con questo attributo impostato su "Pubblico". Se l'attributo è impostato su Private o HiddenMembership, solo i proprietari possono aggiungere nuovi membri al gruppo e le richieste di adesione al gruppo devono essere approvate dai proprietari.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.

Input

None

Output

Object

Note

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

Questo cmdlet è attualmente disponibile in anteprima pubblica. Mentre un cmdlet è in anteprima pubblica, è possibile che vengano apportate modifiche al cmdlet che potrebbero avere effetti imprevisti. Si consiglia di non utilizzare questo cmdlet in un ambiente di produzione.