New-UnifiedGroup

Sintassi

Identity (Impostazione predefinita)

New-UnifiedGroup
    [-DisplayName <String>]
    [-AccessType <ModernGroupTypeInfo>]
    [-MailboxRegion <String>]
    [-Alias <String>]
    [-AlwaysSubscribeMembersToCalendarEvents]
    [-AutoSubscribeNewMembers]
    [-Classification <String>]
    [-Confirm]
    [-DataEncryptionPolicy <DataEncryptionPolicyIdParameter>]
    [-EmailAddresses <ProxyAddressCollection>]
    [-ExecutingUser <RecipientIdParameter>]
    [-ExoErrorAsWarning]
    [-HiddenGroupMembershipEnabled]
    [-IsMemberAllowedToEditContent <System.Boolean>]
    [-Language <CultureInfo>]
    [-ManagedBy <RecipientIdParameter[]>]
    [-Members <RecipientIdParameter[]>]
    [-Name <String>]
    [-Notes <String>]
    [-Owner <RecipientIdParameter>]
    [-PrimarySmtpAddress <SmtpAddress>]
    [-RequireSenderAuthenticationEnabled <Boolean>]
    [-SensitivityLabelId <Sustem.Guid>]
    [-SuppressWarmupMessage]
    [-WhatIf]
    [<CommonParameters>]

ProvisioningOptions

New-UnifiedGroup
    [-DisplayName <String>]
    [-AccessType <ModernGroupTypeInfo>]
    [-Alias <String>]
    [-AlwaysSubscribeMembersToCalendarEvents]
    [-AutoSubscribeNewMembers]
    [-Classification <String>]
    [-Confirm]
    [-DataEncryptionPolicy <DataEncryptionPolicyIdParameter>]
    [-EmailAddresses <ProxyAddressCollection>]
    [-ExecutingUser <RecipientIdParameter>]
    [-ExoErrorAsWarning]
    [-HiddenGroupMembershipEnabled]
    [-Language <CultureInfo>]
    [-ManagedBy <RecipientIdParameter[]>]
    [-Members <RecipientIdParameter[]>]
    [-Name <String>]
    [-Notes <String>]
    [-Owner <RecipientIdParameter>]
    [-PrimarySmtpAddress <SmtpAddress>]
    [-RequireSenderAuthenticationEnabled <Boolean>]
    [-SensitivityLabelId <Sustem.Guid>]
    [-SuppressWarmupMessage]
    [-WhatIf]
    [<CommonParameters>]

SegmentationOption

New-UnifiedGroup
    [-DisplayName <String>]
    [-SubscriptionEnabled]
    [-AccessType <ModernGroupTypeInfo>]
    [-Alias <String>]
    [-AlwaysSubscribeMembersToCalendarEvents]
    [-AutoSubscribeNewMembers]
    [-Classification <String>]
    [-Confirm]
    [-DataEncryptionPolicy <DataEncryptionPolicyIdParameter>]
    [-EmailAddresses <ProxyAddressCollection>]
    [-ExecutingUser <RecipientIdParameter>]
    [-ExoErrorAsWarning]
    [-HiddenGroupMembershipEnabled]
    [-Language <CultureInfo>]
    [-ManagedBy <RecipientIdParameter[]>]
    [-Members <RecipientIdParameter[]>]
    [-Name <String>]
    [-Notes <String>]
    [-Owner <RecipientIdParameter>]
    [-PrimarySmtpAddress <SmtpAddress>]
    [-RequireSenderAuthenticationEnabled <Boolean>]
    [-SensitivityLabelId <Sustem.Guid>]
    [-SuppressWarmupMessage]
    [-WhatIf]
    [<CommonParameters>]

DlMigration

New-UnifiedGroup
    -DlIdentity <DistributionGroupIdParameter>
    [-ConvertClosedDlToPrivateGroup]
    [-DeleteDlAfterMigration]
    [-Confirm]
    [-ExecutingUser <RecipientIdParameter>]
    [-ManagedBy <RecipientIdParameter[]>]
    [-Members <RecipientIdParameter[]>]
    [-Owner <RecipientIdParameter>]
    [-WhatIf]
    [<CommonParameters>]

Descrizione

Esempio

Esempio 1

New-UnifiedGroup -DisplayName "Engineering Department" -Alias "engineering"

Parametri

-AccessType

Applicabile: Exchange Online, componente aggiuntivo di sicurezza predefinito per cassette postali locali

Il parametro AccessType consente di specificare il tipo di privacy per il gruppo di Microsoft 365. I valori validi sono:

• Pubblico: il contenuto e le conversazioni del gruppo sono disponibili per tutti e chiunque può partecipare al gruppo senza l'approvazione di un proprietario del gruppo. Questo è il valore predefinito.
• Privato: il contenuto e le conversazioni del gruppo sono disponibili solo per i membri del gruppo e per partecipare al gruppo è necessaria l'approvazione di un proprietario del gruppo.

È possibile modificare il tipo di privacy in qualsiasi momento nel ciclo di vita del gruppo.

Nota: anche se un utente deve essere un membro per partecipare a un gruppo privato, chiunque può inviare e-mail a un gruppo privato e ricevere risposte dal gruppo privato.

Proprietà dei parametri

Set di parametri

-Alias

Applicabile: Exchange Online, componente aggiuntivo di sicurezza predefinito per cassette postali locali

Il parametro Alias specifica l'alias di Exchange (noto anche come nome alternativo di posta) per il gruppo di Microsoft 365. Questo valore consente di identificare il destinatario come oggetto abilitato alla posta elettronica e non deve essere confuso con più indirizzi di posta elettronica dello stesso destinatario (noti anche come indirizzi proxy). Un destinatario può disporre di un solo valore Alias. La lunghezza massima è 64 caratteri.

Il valore alias può contenere lettere, numeri e i caratteri seguenti:

• !, #, %, *, +, -, /, =, ?, ^, _ e ~.
• $, &, ', ', {, } e | devono essere sottoposti a escape (ad esempio -Alias what`'snew) o l'intero valore racchiuso tra virgolette singole (ad esempio, -Alias 'what'snew'). Il carattere & non è supportato nel valore Alias per la sincronizzazione Microsoft Entra Connect.
• I punti (.) devono essere racchiusi da altri caratteri validi (ad esempio, help.desk).
• Caratteri Unicode da U+00A1 a U+00FF.

Se non si usa il parametro Alias quando si crea un gruppo di Microsoft 365, per il valore Alias viene usato il valore del parametro DisplayName. Gli spazi vengono rimossi, i caratteri non supportati vengono convertiti in punti interrogativi (?) ed è possibile aggiungere numeri per mantenere l'univocità del valore di alias.

Quando si crea un gruppo di Microsoft 365 senza usare il parametro EmailAddresses, il valore Alias viene usato per generare l'indirizzo di posta elettronica principale (alias@domain). I caratteri Unicode supportati sono mappati per adattarsi ai caratteri di testo US-ASCII in modo ottimale. Ad esempio, U+00F6 (ö) viene modificato nell'indirizzo oe di posta elettronica principale.

Il valore dell'alias viene aggiunto al valore della proprietà ExternalDirectoryObjectId e usato come valore della proprietà Name per il gruppo di Microsoft 365 (<Alias>_<ExternalDirectoryObjectId>).

Proprietà dei parametri

Set di parametri

-AlwaysSubscribeMembersToCalendarEvents

Applicabile: Exchange Online, componente aggiuntivo di sicurezza predefinito per cassette postali locali

L'opzione AlwaysSubscribeMembersToCalendarEvents controlla le impostazioni di sottoscrizione predefinite dei nuovi membri aggiunti al gruppo di Microsoft 365.

• Se si usa questa opzione senza un valore, tutte i future sottoscrizioni dei membri aggiunti al gruppo saranno impostate su ReplyAndEvents.
• Se si utilizza questa sintassi esatta: -AlwaysSubscribeMembersToCalendarEvents:$false, tutte le sottoscrizioni dei membri futuri aggiunti al gruppo sono impostate su ReplyOnly.

I membri del gruppo possono modificare le impostazioni della sottoscrizione, che può sovrascrivere l'uso previsto di questa opzione.

L'opzione AutoSubscribeNewMembers consente di sovrascrivere quella attuale.

Proprietà dei parametri

Set di parametri

-AutoSubscribeNewMembers

Applicabile: Exchange Online, componente aggiuntivo di sicurezza predefinito per cassette postali locali

L'opzione AutoSubscribeNewMembers specifica se sottoscrivere automaticamente i nuovi membri aggiunti al gruppo di Microsoft 365 alle conversazioni e agli eventi del calendario. Con questa opzione non è necessario specificare alcun valore.

È necessario utilizzare questa opzione con quella SubscriptionEnabled.

Proprietà dei parametri

Set di parametri

-Classification

Applicabile: Exchange Online, componente aggiuntivo di sicurezza predefinito per cassette postali locali

Questo parametro è riservato all'uso interno da parte di Microsoft.

Proprietà dei parametri

Set di parametri

-Confirm

Applicabile: Exchange Online, componente aggiuntivo di sicurezza predefinito per cassette postali locali

L'opzione Confirm consente di specificare se visualizzare o nascondere la richiesta di conferma. Il modo in cui questa opzione influisce sul cmdlet varia se il cmdlet richiede o meno una conferma prima di procedere.

• I cmdlet distruttivi (ad esempio, i cmdlet Remove-*) dispongono di una pausa incorporata che impone all'utente di confermare il comando prima di procedere. Per questi cmdlet, è possibile ignorare la richiesta di conferma usando questa precisa sintassi: -Confirm:$false.
• La maggior parte degli altri cmdlet (ad esempio, i cmdlet New-* e Set-*) non dispone di una pausa incorporata. Per questi cmdlet, se si specifica l'opzione Confirm senza un valore, viene introdotta una pausa che impone di confermare il comando prima di procedere.

Proprietà dei parametri

Set di parametri

-ConvertClosedDlToPrivateGroup

Applicabile: Exchange Online, componente aggiuntivo di sicurezza predefinito per cassette postali locali

L'opzione ConvertClosedDlToPrivateGroup specifica se eseguire la migrazione del gruppo di distribuzione chiuso a un gruppo di Microsoft 365 privato. Con questa opzione non è necessario specificare alcun valore.

Per impostazione predefinita, questa opzione viene sempre applicata durante la migrazione di gruppi di distribuzione chiusi e non è più necessaria.

Se il gruppo di distribuzione ha il valore Closed per i parametri MemberDepartRestriction o MemberJoinRestriction, la migrazione del gruppo di distribuzione viene sempre eseguita in un gruppo di Microsoft 365 privato. Per i gruppi di distribuzione aperti, il gruppo di Microsoft 365 migrato è sempre pubblico, non privato.

È possibile utilizzare questa opzione solo con il parametro DlIdentity.

Proprietà dei parametri

Set di parametri

-DataEncryptionPolicy

Applicabile: Exchange Online, componente aggiuntivo di sicurezza predefinito per cassette postali locali

Il parametro DataEncryptionPolicy specifica i criteri di crittografia dei dati applicati al gruppo di Microsoft 365. È possibile utilizzare qualsiasi valore che identifichi il criterio in modo univoco. Ad esempio:

• Nome
• Nome distinto (DN)
• GUID

Proprietà dei parametri

Set di parametri

-DeleteDlAfterMigration

Applicabile: Exchange Online, componente aggiuntivo di sicurezza predefinito per cassette postali locali

L'opzione DeleteDlAfterMigration specifica se eliminare il gruppo di distribuzione dopo la migrazione a un gruppo di Microsoft 365. Con questa opzione non è necessario specificare alcun valore.

È possibile utilizzare questa opzione solo con il parametro DlIdentity.

Proprietà dei parametri

Set di parametri

-DisplayName

Applicabile: Exchange Online, componente aggiuntivo di sicurezza predefinito per cassette postali locali

Il parametro DisplayName consente di specificare il nome del gruppo di Microsoft 365. Il nome visualizzato è visibile nell'interfaccia di amministrazione di Exchange, negli elenchi indirizzi e in Outlook. La lunghezza massima è 64 caratteri. Se il valore contiene degli spazi, è necessario racchiuderlo tra virgolette (").

Per i Gruppi di Microsoft 365, il valore DisplayName viene usato nella proprietà Name univoca. Tuttavia, poiché il valore DisplayName non deve essere univoco, al valore DisplayName viene aggiunto un carattere di sottolineatura (_) e un valore GUID breve quando viene usato per la proprietà Name.

Proprietà dei parametri

Set di parametri

-DlIdentity

Applicabile: Exchange Online, componente aggiuntivo di sicurezza predefinito per cassette postali locali

Il parametro DlIdentity consente di specificare il gruppo di distribuzione (noto anche come lista di distribuzione o DL) di cui si vuole eseguire la migrazione a un gruppo di Microsoft 365. Il gruppo di distribuzione deve essere un gruppo di distribuzione universale (il valore della proprietà RecipientTypeDetails è MailUniversalDistributionGroup). È possibile utilizzare qualsiasi valore che identifichi il gruppo di distribuzione in modo univoco. Ad esempio:

• Nome
• Alias
• Nome distinto (DN)
• Nome distinto (DN)
• Nome distinto canonico
• GUID

Tutte le proprietà e l'appartenenza del gruppo di distribuzione vengono copiate nel gruppo di Microsoft 365.

Gli alias e gli indirizzi proxy del gruppo di distribuzione vengono spostati nel gruppo di Microsoft 365 e vengono sostituiti nel gruppo di distribuzione dai valori DLMigrated_<GUID>. Gli indirizzi proxy originali vengono copiati nella proprietà ExtensionCustomAttribute5 del gruppo di distribuzione.

I Gruppi di Microsoft 365 non hanno parametri ReportToManager e ReportToOriginator, quindi i valori di questi parametri non vengono migrati dal gruppo di distribuzione al gruppo di Microsoft 365. Il gruppo di Microsoft 365 si comporta come se fossero impostati i valori predefiniti di questi parametri (ReportToManager è $false e ReportToOriginator è $true). In altre parole, le notifiche sullo stato del recapito (note anche come DSN, rapporti di mancato recapito, rapporti NDR o messaggi di mancato recapito) vengono inviate al mittente del messaggio e non al proprietario del gruppo di Microsoft 365.

Proprietà dei parametri

Set di parametri

-EmailAddresses

Applicabile: Exchange Online, componente aggiuntivo di sicurezza predefinito per cassette postali locali

Il parametro EmailAddresses consente di specificare tutti gli indirizzi di posta elettronica (indirizzi proxy) per il gruppo di Microsoft 365, incluso l'indirizzo SMTP primario. Nelle organizzazioni basate su cloud, l'indirizzo SMTP primario e altri indirizzi proxy per i Gruppi di Microsoft 365 sono in genere impostati dai criteri degli indirizzi di posta elettronica. Tuttavia, è possibile usare questo parametro per configurare altri indirizzi proxy per il gruppo di Microsoft 365.

La sintassi valida per questo parametro è "Type:EmailAddress1","Type:EmailAddress2",..."Type:EmailAddressN". Il valore facoltativo Type specifica il tipo di indirizzo di posta elettronica. Esempi di valori validi sono:

• SMTP: l'indirizzo SMTP primario. Questo valore può essere usato una sola volta in un comando.
• SMTP: indirizzo SMTP primario. È possibile utilizzare questo valore solo una volta in un comando.
• SPO: indirizzo di posta elettronica di SharePoint.

Se non si include un valore Type per un indirizzo di posta elettronica, si presuppone che sia un indirizzo di posta elettronica SMTP. La sintassi degli indirizzi di posta elettronica SMTP viene convalidata, ma non viene convalidata la sintassi di altri tipi di indirizzi di posta elettronica. Pertanto, è necessario verificare che gli indirizzi personalizzati siano formattati correttamente.

Se non si include un valore per un indirizzo di posta elettronica, verrà utilizzato il valore smtp. exExchangeNoVersion non esegue la convalida della sintassi dei tipi di indirizzo personalizzati (tra cui indirizzi X.400). Pertanto, è necessario verificare che gli indirizzi personalizzati siano formattati correttamente.

• Usare il valore di tipo SMTP nell'indirizzo.
• Il primo indirizzo di posta elettronica se non si utilizzano valori Type o se si utilizzano più valori di tipo SMTP minuscolo.
• Utilizzare invece il parametro PrimarySmtpAddress. Non è possibile utilizzare il parametro EmailAddresses e il parametro PrimarySmtpAddress nello stesso comando.

Proprietà dei parametri

Set di parametri

-ExecutingUser

Applicabile: Exchange Online, componente aggiuntivo di sicurezza predefinito per cassette postali locali

Questo parametro è riservato all'uso interno da parte di Microsoft.

Proprietà dei parametri

Set di parametri

-ExoErrorAsWarning

Applicabile: Exchange Online, componente aggiuntivo di sicurezza predefinito per cassette postali locali

L'opzione ExoErrorAsWarning specifica che gli errori di Exchange Online riscontrati durante la creazione del gruppo di Microsoft 365 vengono trattati come avvisi, non errori. Con questa opzione non è necessario specificare alcun valore.

La creazione di Gruppi di Microsoft 365 implica operazioni in background in Microsoft Entra ID ed Exchange Online. Gli errori che possono verificarsi in Exchange Online non impediscono la creazione del gruppo (e quindi non sono realmente errori), perché l'oggetto gruppo in Microsoft Entra ID viene sincronizzato di nuovo con Exchange Online.

Proprietà dei parametri

Set di parametri

-HiddenGroupMembershipEnabled

Applicabile: Exchange Online, componente aggiuntivo di sicurezza predefinito per cassette postali locali

L'opzione HiddenGroupMembershipEnabled specifica se nascondere i membri del gruppo di Microsoft 365 agli utenti che non sono membri del gruppo. Con questa opzione non è necessario specificare alcun valore.

È possibile usare questa impostazione per rispettare le normative che richiedono di nascondere l'appartenenza al gruppo agli utenti esterni (ad esempio, un gruppo di Microsoft 365 che rappresenta gli studenti iscritti a un corso).

Nota: Non è possibile modificare questa impostazione una volta creato il gruppo. Se si crea il gruppo con l'appartenenza nascosta, non sarà possibile modificare il gruppo in un secondo momento per rivelarne l'appartenenza al gruppo o viceversa. Inoltre, i Gruppi di Microsoft 365 con appartenenza a gruppi nascosti non sono supportati nei criteri di etichettatura di riservatezza.

Proprietà dei parametri

Set di parametri

-IsMemberAllowedToEditContent

Applicabile: Exchange Online, componente aggiuntivo di sicurezza predefinito per cassette postali locali

{{ Fill IsMemberAllowedToEditContent Description }}

Proprietà dei parametri

Set di parametri

-Language

Applicabile: Exchange Online, componente aggiuntivo di sicurezza predefinito per cassette postali locali

Il parametro Language consente di specificare la preferenza di lingua per il gruppo di Microsoft 365.

L'input valido per questo parametro è un valore di codice delle impostazioni cultura supportato dalla classe CultureInfo di Microsoft .NET Framework. Ad esempio, da-DK per il danese o ja-JP per il giapponese. Per altre informazioni, vedere Classe CultureInfo.

Proprietà dei parametri

Set di parametri

-MailboxRegion

Applicabile: Exchange Online, componente aggiuntivo di sicurezza predefinito per cassette postali locali

Il parametro MailboxRegion specifica il percorso dati preferito (PDL) per il gruppo di Microsoft 365 in ambienti multi-geografici.

Proprietà dei parametri

Set di parametri

-ManagedBy

Applicabile: Exchange Online, componente aggiuntivo di sicurezza predefinito per cassette postali locali

Questo parametro è riservato all'uso interno da parte di Microsoft.

Proprietà dei parametri

Set di parametri

-Members

Applicabile: Exchange Online, componente aggiuntivo di sicurezza predefinito per cassette postali locali

Il parametro Members consente di specificare i destinatari (oggetti abilitati alla posta elettronica) che sono membri del gruppo di Microsoft 365. È possibile utilizzare qualsiasi valore che identifichi il destinatario in modo univoco. Esempio:

• Nome
• Alias
• Nome distinto (DN)
• Nome distinto (DN)
• Nome distinto canonico
• GUID

È possibile immettere più valori separati da virgole. Se i valori contengono spazi o richiedono le virgolette, utilizzare la sintassi seguente: "Value1","Value2",..."ValueN".

Proprietà dei parametri

Set di parametri

-Name

Applicabile: Exchange Online, componente aggiuntivo di sicurezza predefinito per cassette postali locali

Questo parametro è deprecato e non viene più utilizzato.

In precedenza, se si specificava un valore per questo parametro, veniva aggiunto un valore GUID casuale e usato come valore della proprietà Nome per il gruppo di Microsoft 365 (Name_<RandomGUID>). A questo punto, il valore della proprietà Name viene popolato dal valore del parametro Alias e dal valore della proprietà ExternalDirectoryObjectId (<Alias>_<ExternalDirectoryObjectId>).

Proprietà dei parametri

Set di parametri

-Notes

Applicabile: Exchange Online, componente aggiuntivo di sicurezza predefinito per cassette postali locali

Il parametro Notes specifica la descrizione del gruppo di Microsoft 365. Se il valore contiene spazi è necessario racchiuderlo tra virgolette.

Proprietà dei parametri

Set di parametri

-Owner

Applicabile: Exchange Online, componente aggiuntivo di sicurezza predefinito per cassette postali locali

Il parametro Owner consente di specificare il per il gruppo di Microsoft 365. Un proprietario è un membro del gruppo che dispone di determinati privilegi, ad esempio la possibilità di modificare le proprietà del gruppo.

Il proprietario specificato per questo parametro deve essere una cassetta postale o un utente di posta (un'entità di protezione abilitata alla posta che può disporre di autorizzazioni). È possibile utilizzare qualsiasi valore che identifichi il proprietario in modo univoco. Ad esempio:

• Nome
• Alias
• Nome distinto (DN)
• Nome distinto (DN)
• Nome distinto canonico
• GUID

Proprietà dei parametri

Set di parametri

-PrimarySmtpAddress

Applicabile: Exchange Online, componente aggiuntivo di sicurezza predefinito per cassette postali locali

Il parametro PrimarySmtpAddress consente di specificare l'indirizzo di posta elettronica primario di risposta utilizzato per il destinatario. Non è possibile utilizzare i parametri EmailAddresses e PrimarySmtpAddress nello stesso comando.

Proprietà dei parametri

Set di parametri

-RequireSenderAuthenticationEnabled

Applicabile: Exchange Online, componente aggiuntivo di sicurezza predefinito per cassette postali locali

Il parametro RequireSenderAuthenticationEnabled consente di specificare se accettare messaggi solo da mittenti autenticati (interni). I valori validi sono:

• $true: i messaggi vengono accettati solo da mittenti autenticati (interni). I messaggi provenienti da mittenti esterni non autenticati vengono rifiutati.
• $true: i messaggi vengono accettati solo dai mittenti autenticati (interni). I messaggi provenienti da mittenti non autenticati (esterni) vengono rifiutati.

Proprietà dei parametri

Set di parametri

-SensitivityLabelId

Applicabile: Exchange Online, componente aggiuntivo di sicurezza predefinito per cassette postali locali

Il parametro SensitivityLabelId specifica il valore GUID dell'etichetta di riservatezza assegnata al gruppo di Microsoft 365.

Nota: nell'output del cmdlet Get-UnifiedGroup, questa proprietà è denominata SensitivityLabel, non SensitivityLabelId.

Proprietà dei parametri

Set di parametri

-SubscriptionEnabled

Applicabile: Exchange Online, componente aggiuntivo di sicurezza predefinito per cassette postali locali

L'opzione SubscriptionEnabled specifica se le sottoscrizioni alle conversazioni e agli eventi del calendario sono abilitate per il gruppo di Microsoft 365. Con questa opzione non è necessario specificare alcun valore.

Proprietà dei parametri

Set di parametri

-SuppressWarmupMessage

Applicabile: Exchange Online, componente aggiuntivo di sicurezza predefinito per cassette postali locali

Questo parametro è deprecato e non viene più utilizzato.

Proprietà dei parametri

Set di parametri

-WhatIf

Applicabile: Exchange Online, componente aggiuntivo di sicurezza predefinito per cassette postali locali

L'opzione WhatIf mostra le operazioni eseguite dal comando senza apportare modifiche. Con questa opzione non è necessario specificare alcun valore.

Proprietà dei parametri

Set di parametri

CommonParameters