New-AzADGroup

Sintassi

Default (impostazione predefinita).

New-AzADGroup
    -DisplayName <String>
    -MailNickname <String>
    [-AcceptedSender <IMicrosoftGraphDirectoryObject[]>]
    [-AdditionalProperties <Hashtable>]
    [-AppRoleAssignment <IMicrosoftGraphAppRoleAssignmentAutoGenerated[]>]
    [-Classification <String>]
    [-CreatedOnBehalfOf <IMicrosoftGraphDirectoryObject>]
    [-DeletedDateTime <DateTime>]
    [-Description <String>]
    [-GroupType <String[]>]
    [-HasMembersWithLicenseError]
    [-IsArchived]
    [-IsAssignableToRole]
    [-MailEnabled]
    [-MembershipRule <String>]
    [-MembershipRuleProcessingState <String>]
    [-PermissionGrant <IMicrosoftGraphResourceSpecificPermissionGrant[]>]
    [-PreferredDataLocation <String>]
    [-PreferredLanguage <String>]
    [-SecurityEnabled]
    [-SecurityIdentifier <String>]
    [-Theme <String>]
    [-TransitiveMember <IMicrosoftGraphDirectoryObject[]>]
    [-TransitiveMemberOf <IMicrosoftGraphDirectoryObject[]>]
    [-Visibility <String>]
    [-DefaultProfile <PSObject>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Descrizione

Esempio

Esempio 1: Creare un gruppo

New-AzADGroup -DisplayName $gname -MailNickname $nickname

Parametri

-AcceptedSender

Elenco di utenti o gruppi autorizzati a creare eventi di post o di calendario in questo gruppo. Se questo elenco non è vuoto, solo gli utenti o i gruppi elencati qui sono autorizzati a pubblicare. Per costruire, vedere la sezione NOTES per le proprietà ACCEPTEDSENDER e creare una tabella hash.

Proprietà dei parametri

Set di parametri

-AdditionalProperties

Altri parametri

Proprietà dei parametri

Set di parametri

-AppRoleAssignment

Rappresenta i ruoli dell'app a cui è stato concesso un gruppo per un'applicazione. Supporta $expand. Per costruire, vedere la sezione NOTES per le proprietà APPROLEASSIGNMENT e creare una tabella hash.

Proprietà dei parametri

Set di parametri

-Classification

Descrive una classificazione per il gruppo( ad esempio basso, medio o alto impatto aziendale). I valori validi per questa proprietà vengono definiti creando un valore di impostazione ClassificationList, in base alla definizione del modello. Restituito per impostazione predefinita. Supporta $filter (eq, ne, NOT, ge, le, startsWith).

Proprietà dei parametri

Set di parametri

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Proprietà dei parametri

Set di parametri

-CreatedOnBehalfOf

Rappresenta un oggetto Azure Active Directory. Il tipo directoryObject è il tipo di base per molti altri tipi di entità di directory. Per costruire, vedere la sezione NOTES per le proprietà CREATEDONBEHALFOF e creare una tabella hash.

Proprietà dei parametri

Set di parametri

-DefaultProfile

Le credenziali, l’account, il tenant e la sottoscrizione usati per comunicare con Azure.

Proprietà dei parametri

Set di parametri

-DeletedDateTime

.

Proprietà dei parametri

Set di parametri

-Description

Descrizione facoltativa per il gruppo. Restituito per impostazione predefinita. Supporta $filter (eq, ne, NOT, ge, le, startsWith) e $search.

Proprietà dei parametri

Set di parametri

-DisplayName

Nome visualizzato per il gruppo. Questa proprietà è obbligatoria quando viene creato un gruppo e non può essere cancellata durante gli aggiornamenti. Restituito per impostazione predefinita. Supporta $filter (eq, ne, NOT, ge, le, in, startsWith), $search e $orderBy.

Proprietà dei parametri

Set di parametri

-GroupType

Specifica il tipo di gruppo e la relativa appartenenza. Se la raccolta contiene Unified, il gruppo è un gruppo di Microsoft 365; in caso contrario, si tratta di un gruppo di sicurezza o di un gruppo di distribuzione. Per informazioni dettagliate, vedere Panoramica dei gruppi. Se la raccolta include DynamicMembership, il gruppo ha appartenenza dinamica; in caso contrario, l'appartenenza è statica. Restituito per impostazione predefinita. Supporta $filter (eq, NOT).

Proprietà dei parametri

Set di parametri

-HasMembersWithLicenseError

Indica se in questo gruppo sono presenti membri che presentano errori di licenza dall'assegnazione di licenze basata su gruppo. Questa proprietà non viene mai restituita in un'operazione GET. È possibile usarlo come argomento $filter per ottenere gruppi con membri con errori di licenza, ovvero filtrare per questa proprietà in modo che sia true. Supporta $filter (eq).

Proprietà dei parametri

Set di parametri

-IsArchived

.

Proprietà dei parametri

Set di parametri

-IsAssignableToRole

Indica se questo gruppo può essere assegnato a un ruolo di Azure Active Directory. Questa proprietà può essere impostata solo durante la creazione del gruppo ed è non modificabile. Se impostato su true, la proprietà securityEnabled deve essere impostata anche su true e il gruppo non può essere un gruppo dinamico, ovvero groupTypes non può contenere DynamicMembership. Solo i chiamanti nei ruoli Amministratore globale e Amministratore ruolo con privilegi possono impostare questa proprietà. Al chiamante deve essere assegnata anche l'autorizzazione Directory.AccessAsUser.All per impostare questa proprietà. Per altre informazioni, vedere Uso di un gruppo per gestire le assegnazioni di ruolo di Azure ADReturned per impostazione predefinita. Supporta $filter (eq, ne, NOT).

Proprietà dei parametri

Set di parametri

-MailEnabled

Specifica se il gruppo è abilitato alla posta elettronica. Restituito per impostazione predefinita. Supporta $filter (eq, ne, NOT).

Proprietà dei parametri

Set di parametri

-MailNickname

Alias di posta elettronica per il gruppo, univoco nell'organizzazione. Questa proprietà deve essere specificata quando viene creato un gruppo. Questi caratteri non possono essere usati in mailNickName: @()/[]';:.<>,SPACE. Restituito per impostazione predefinita. Supporta $filter (eq, ne, NOT, ge, le, in, startsWith).

Proprietà dei parametri

Set di parametri

-MembershipRule

Regola che determina i membri per questo gruppo se il gruppo è un gruppo dinamico (groupTypes contiene DynamicMembership). Per altre informazioni sulla sintassi della regola di appartenenza, vedere sintassi delle regole di appartenenza. Restituito per impostazione predefinita. Supporta $filter (eq, ne, NOT, ge, le, startsWith).

Proprietà dei parametri

Set di parametri

-MembershipRuleProcessingState

Indica se l'elaborazione dell'appartenenza dinamica è attiva o sospesa. I valori possibili sono On o Paused. Restituito per impostazione predefinita. Supporta $filter (eq, ne, NOT, in).

Proprietà dei parametri

Set di parametri

-PermissionGrant

Autorizzazioni concesse per un gruppo a un'applicazione specifica. Supporta $expand. Per costruire, vedere la sezione NOTES per le proprietà PERMISSIONGRANT e creare una tabella hash.

Proprietà dei parametri

Set di parametri

-PreferredDataLocation

Posizione dei dati preferita per il gruppo. Per altre informazioni, vedere OneDrive Online Multi-Geo. Restituito per impostazione predefinita.

Proprietà dei parametri

Set di parametri

-PreferredLanguage

Lingua preferita per un gruppo di Microsoft 365. Deve seguire il codice ISO 639-1; ad esempio 'en-US'. Restituito per impostazione predefinita. Supporta $filter (eq, ne, NOT, ge, le, in, startsWith).

Proprietà dei parametri

Set di parametri

-SecurityEnabled

Specifica se il gruppo è un gruppo di sicurezza. Restituito per impostazione predefinita. Supporta $filter (eq, ne, NOT, in).

Proprietà dei parametri

Set di parametri

-SecurityIdentifier

Identificatore di sicurezza del gruppo, usato negli scenari di Windows. Restituito per impostazione predefinita.

Proprietà dei parametri

Set di parametri

-Theme

Specifica il tema colore di un gruppo di Microsoft 365. I valori possibili sono Teal, Purple, Green, Blue, Pink, Orange o Red. Restituito per impostazione predefinita.

Proprietà dei parametri

Set di parametri

-TransitiveMember

. Per costruire, vedere la sezione NOTES per le proprietà TRANSITIVEMEMBER e creare una tabella hash.

Proprietà dei parametri

Set di parametri

-TransitiveMemberOf

. Per costruire, vedere la sezione NOTES per le proprietà TRANSITIVEMEMBEROF e creare una tabella hash.

Proprietà dei parametri

Set di parametri

-Visibility

Specifica i criteri di join di gruppo e la visibilità del contenuto del gruppo per i gruppi. I valori possibili sono: Private, Public o Hiddenmembership. Hiddenmembership può essere impostato solo per i gruppi di Microsoft 365, quando vengono creati i gruppi. Non può essere aggiornato in un secondo momento. È possibile aggiornare altri valori di visibilità dopo la creazione del gruppo. Se il valore di visibilità non viene specificato durante la creazione di gruppi in Microsoft Graph, un gruppo di sicurezza viene creato come Privato per impostazione predefinita e il gruppo di Microsoft 365 è Pubblico. Per altre informazioni, vedere Opzioni di visibilità dei gruppi. Restituito per impostazione predefinita.

Proprietà dei parametri

Set di parametri

-WhatIf

Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.

Proprietà dei parametri

Set di parametri

CommonParameters

Output

IMicrosoftGraphGroup