New-UnifiedGroup

Sintaxe

Identity (Default)

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

Description

Exemplos

Exemplo 1

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

Parâmetros

-AccessType

Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local

O parâmetro AccessType especifica o tipo de privacidade do Grupo do Microsoft 365. Os valores válidos são:

• Público: o conteúdo do grupo e as conversações estão disponíveis para todos e qualquer pessoa pode aderir ao grupo sem a aprovação de um proprietário do grupo. Este valor é a predefinição.
• Privado: o conteúdo do grupo e as conversações só estão disponíveis para os membros do grupo e a adesão ao grupo requer a aprovação de um proprietário do grupo.

Você pode alterar o tipo de privacidade em qualquer ponto no ciclo de vida do grupo.

Nota: embora um utilizador precise de ser membro para participar num grupo privado, qualquer pessoa pode enviar e-mails para um grupo privado e receber respostas do grupo privado.

Propriedades do parâmetro

Conjuntos de parâmetros

-Alias

Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local

O parâmetro Alias especifica o alias do Exchange (também conhecido como alcunha de correio) para o Grupo do Microsoft 365. Esse valor identifica o destinatário como um objeto habilitado para email e não deve ser confundido com vários endereços de email para o mesmo destinatário (também conhecido como endereços de proxy). Um destinatário pode ter apenas um valor de Alias. O tamanho máximo é de 64 caracteres.

O valor Alias pode conter letras, números e os seguintes carateres:

• !, #, %, *, +, -, /, =, ?, ^, _, e ~.
• $, &, ', ', {, }, and | tem de ser escapado (por exemplo -Alias what`'snew, ) ou todo o valor entre plicas (por exemplo, -Alias 'what'snew'). O caráter & não é suportado no valor de Alias para a sincronização do Microsoft Entra Connect.
• Os períodos (.) têm de estar rodeados por outros carateres válidos (por exemplo, help.desk).
• Carateres Unicode U+00A1 a U+00FF.

Se não utilizar o parâmetro Alias quando cria um Grupo do Microsoft 365, o valor do parâmetro DisplayName é utilizado para o valor Alias. Os espaços são removidos, os carateres não suportados são convertidos em pontos de interrogação (?) e os números podem ser adicionados para manter a exclusividade do valor Alias.

Quando cria um Grupo do Microsoft 365 sem utilizar o parâmetro EmailAddresses, o valor Alias é utilizado para gerar o endereço de email principal (alias@domain). Os caracteres Unicode com suporte são mapeados para os melhores caracteres de texto US-ASCII. Por exemplo, U+00F6 (ö) é alterado para oe no endereço de email principal.

O valor de Alias é anexado com o valor da propriedade ExternalDirectoryObjectId e utilizado como o valor da propriedade Nome do Grupo do Microsoft 365 (<Alias>_<ExternalDirectoryObjectId>).

Propriedades do parâmetro

Conjuntos de parâmetros

-AlwaysSubscribeMembersToCalendarEvents

Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local

O comutador AlwaysSubscribeMembersToCalendarEvents controla as predefinições de subscrição dos novos membros que são adicionados ao Grupo do Microsoft 365.

• Se utilizar este parâmetro sem um valor, todos os membros futuros que são adicionados ao grupo têm as respetivas subscrições definidas como ReplyAndEvents.
• Se utilizar esta sintaxe exata: -AlwaysSubscribeMembersToCalendarEvents:$false, todos os futuros membros que são adicionados ao grupo têm as respetivas subscrições definidas como ReplyOnly.

Os membros do grupo podem alterar as próprias configurações de assinatura, o que pode substituir o uso original dessa opção.

A opção AutoSubscribeNewMembers substitui essa opção.

Propriedades do parâmetro

Conjuntos de parâmetros

-AutoSubscribeNewMembers

Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local

O comutador AutoSubscribeNewMembers especifica se pretende subscrever automaticamente novos membros que são adicionados ao Grupo do Microsoft 365 a conversações e eventos de calendário. Não é preciso especificar um valor com essa opção.

Use esta opção com a opção SubscriptionEnabled.

Propriedades do parâmetro

Conjuntos de parâmetros

-Classification

Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local

Esse parâmetro está reservado para uso interno da Microsoft.

Propriedades do parâmetro

Conjuntos de parâmetros

-Confirm

Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local

A opção Confirm especifica se a solicitação de confirmação deve ser mostrada ou ocultada. Como essa opção afeta o cmdlet dependerá do fato de o cmdlet exigir ou não confirmação antes de continuar.

• Cmdlets destrutivos (por exemplo, Remover- cmdlets) têm uma pausa interna que força você a confirmar o comando antes de continuar. Para estes cmdlets, você pode pular o pedido de confirmação usando esta sintaxe exata: -Confirm:$false.
• A maioria dos outros cmdlets (por exemplo, New- e Set-) não tem uma pausa interna. Para esses cmdlets, especificar a opção Confirm sem um valor introduz uma pausa que força você a confirmar o comando antes de continuar.

Propriedades do parâmetro

Conjuntos de parâmetros

-ConvertClosedDlToPrivateGroup

Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local

O comutador ConvertClosedDlToPrivateGroup especifica se pretende migrar o grupo de distribuição fechado para um Grupo privado do Microsoft 365. Não é preciso especificar um valor com essa opção.

Por predefinição, este comutador é sempre aplicado ao migrar grupos de distribuição fechados e já não é necessário.

Se o grupo de distribuição tiver o valor Fechado para os parâmetros MemberDepartRestriction ou MemberJoinRestriction, o grupo de distribuição é sempre migrado para um Grupo privado do Microsoft 365. Para grupos de distribuição abertos, o Grupo do Microsoft 365 migrado é sempre público e não privado.

Você pode usar essa opção apenas com o parâmetro DlIdentity.

Propriedades do parâmetro

Conjuntos de parâmetros

-DataEncryptionPolicy

Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local

O parâmetro DataEncryptionPolicy especifica a política de encriptação de dados que é aplicada ao Grupo do Microsoft 365. É possível usar qualquer valor que identifique a política com exclusividade. Por exemplo:

• Nome
• DN (nome diferenciado)
• GUID

Propriedades do parâmetro

Conjuntos de parâmetros

-DeleteDlAfterMigration

Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local

O comutador DeleteDlAfterMigration especifica se pretende eliminar o grupo de distribuição depois de ser migrado para um Grupo do Microsoft 365. Não é preciso especificar um valor com essa opção.

Você pode usar essa opção apenas com o parâmetro DlIdentity.

Propriedades do parâmetro

Conjuntos de parâmetros

-DisplayName

Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local

O parâmetro DisplayName especifica o nome do Grupo do Microsoft 365. O nome a apresentar é visível no centro de administração do Exchange, nas listas de endereços e no Outlook. O tamanho máximo é de 64 caracteres. Se o valor contiver espaços, coloque-o entre aspas (").

Para Grupos do Microsoft 365, o valor DisplayName é utilizado na propriedade Nome exclusivo. No entanto, como o valor DisplayName não precisa de ser exclusivo, o valor DisplayName é acrescentado com um caráter de sublinhado (_) e um valor GUID curto quando é utilizado para a propriedade Nome.

Propriedades do parâmetro

Conjuntos de parâmetros

-DlIdentity

Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local

O parâmetro DlIdentity especifica o grupo de distribuição (também conhecido como lista de distribuição ou DL) que pretende migrar para um Grupo do Microsoft 365. O grupo de distribuição deve ser um grupo de distribuição universal (o valor da propriedade RecipientTypeDetails é MailUniversalDistributionGroup). É possível usar qualquer valor que identifique o grupo de distribuição com exclusividade. Por exemplo:

• Nome
• Alias
• Nome diferenciado (DN)
• Nome diferenciado (DN)
• DN canônico
• GUID

Todas as propriedades e associações do grupo de distribuição são copiadas para o Grupo do Microsoft 365.

Os endereços de alias e proxy do grupo de distribuição são movidos para o Grupo do Microsoft 365 e são substituídos no grupo de distribuição pelos valores DLMigrated_<GUID>. Os endereços proxy originais são copiados para a propriedade ExtensionCustomAttribute5 do grupo de distribuição.

Grupos do Microsoft 365 não têm os parâmetros ReportToManager e ReportToOriginator, pelo que os valores destes parâmetros não são migrados do grupo de distribuição para o Grupo do Microsoft 365. O Grupo do Microsoft 365 comporta-se como se os valores predefinidos destes parâmetros fossem definidos (ReportToManager é $false e ReportToOriginator é $true). Por outras palavras, as notificações de status de entrega (também conhecidas como DSNs, relatórios de entrega sem êxito, NDRs ou mensagens de devolução) são enviadas para o remetente da mensagem e não para o proprietário do Grupo do Microsoft 365.

Propriedades do parâmetro

Conjuntos de parâmetros

-EmailAddresses

Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local

O parâmetro EmailAddresses especifica todos os endereços de e-mail (endereços proxy) para o Grupo do Microsoft 365, incluindo o endereço SMTP principal. Nas organizações baseadas na cloud, o endereço SMTP principal e outros endereços proxy para Grupos do Microsoft 365 são normalmente definidos por políticas de endereço de e-mail. No entanto, pode utilizar este parâmetro para configurar outros endereços proxy para o Grupo do Microsoft 365.

A sintaxe válida para este parâmetro é "Type:EmailAddress1","Type:EmailAddress2",..."Type:EmailAddressN". O valor opcional Type especifica o tipo de endereço de e-mail. Exemplos de valores válidos incluem:

• SMTP: o endereço SMTP principal. Só pode utilizar este valor uma vez num comando.
• SMTP: o endereço SMTP principal. Você pode usar esse valor apenas uma vez em um comando.
• SPO: endereço de e-mail do SharePoint.

Se não incluir um valor tipo para um endereço de e-mail, assume-se que o endereço é um endereço de e-mail SMTP. A sintaxe dos endereços de e-mail SMTP é validada, mas a sintaxe de outros tipos de endereços de e-mail não é validada. Por conseguinte, tem de verificar se os endereços personalizados estão formatados corretamente.

Se você não incluir um valor de para um endereço de email, será presumido o valor smtp. Observe que exExchangeNoVersion não valida a sintaxe de tipos de endereço personalizados (incluindo endereços X.400). Portanto, você precisa verificar se todos os endereços personalizados estão formatados corretamente.

• Utilize o Valor do tipo SMTP no endereço.
• O primeiro endereço de e-mail quando não utiliza valores de Tipo ou quando utiliza vários valores de tipo smtp em minúsculas.
• Em alternativa, utilize o parâmetro PrimarySmtpAddress. Não pode utilizar o parâmetro EmailAddresses e o parâmetro PrimarySmtpAddress no mesmo comando.

Propriedades do parâmetro

Conjuntos de parâmetros

-ExecutingUser

Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local

Esse parâmetro está reservado para uso interno da Microsoft.

Propriedades do parâmetro

Conjuntos de parâmetros

-ExoErrorAsWarning

Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local

O comutador ExoErrorAsWarning especifica que Exchange Online erros encontrados ao criar o Grupo do Microsoft 365 são tratados como avisos e não como erros. Não é preciso especificar um valor com essa opção.

A criação de Grupos do Microsoft 365 envolve operações em segundo plano em Microsoft Entra ID e Exchange Online. Os erros que poderá encontrar no Exchange Online não impedem a criação do grupo (e, portanto, não são realmente erros), porque o objeto de grupo no Microsoft Entra ID é sincronizado de volta para Exchange Online.

Propriedades do parâmetro

Conjuntos de parâmetros

-HiddenGroupMembershipEnabled

Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local

O comutador HiddenGroupMembershipEnabled especifica se pretende ocultar os membros do Grupo do Microsoft 365 de utilizadores que não são membros do grupo. Não é preciso especificar um valor com essa opção.

Pode utilizar esta definição para ajudar a cumprir os regulamentos que exigem que oculte a associação a grupos de pessoas de fora (por exemplo, um Grupo do Microsoft 365 que representa os estudantes inscritos numa turma).

Observação: não é possível alterar esta configuração após criar o grupo. Se criar o grupo com associação oculta, não poderá editar o grupo mais tarde para revelar a associação ao grupo ou vice-versa. Além disso, quaisquer Grupos do Microsoft 365 com associação a grupos ocultos não são suportadas em políticas de etiquetagem de confidencialidade.

Propriedades do parâmetro

Conjuntos de parâmetros

-IsMemberAllowedToEditContent

Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local

{{ Fill IsMemberAllowedToEditContent Description }}

Propriedades do parâmetro

Conjuntos de parâmetros

-Language

Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local

O parâmetro Idioma especifica a preferência de idioma para o Grupo do Microsoft 365.

A entrada válida para este parâmetro é um valor de código de cultura suportado da classe CultureInfo do Microsoft .NET Framework. Por exemplo, da-DK para dinamarquês ou ja-JP para japonês. Para obter mais informações, consulte Classe CultureInfo.

Propriedades do parâmetro

Conjuntos de parâmetros

-MailboxRegion

Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local

O parâmetro MailboxRegion especifica a localização de dados preferencial (PDL) para o Grupo do Microsoft 365 em ambientes multigeográficos.

Propriedades do parâmetro

Conjuntos de parâmetros

-ManagedBy

Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local

Esse parâmetro está reservado para uso interno da Microsoft.

Propriedades do parâmetro

Conjuntos de parâmetros

-Members

Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local

O parâmetro Membros especifica os destinatários (objetos com capacidade de correio) que são membros do Grupo do Microsoft 365. É possível usar qualquer valor que identifique o destinatário com exclusividade. Por exemplo:

• Nome
• Alias
• Nome diferenciado (DN)
• Nome diferenciado (DN)
• DN canônico
• GUID

Update Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "Value1","Value2",..."ValueN".

Propriedades do parâmetro

Conjuntos de parâmetros

-Name

Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local

Este parâmetro foi preterido e já não é utilizado.

Anteriormente, se especificou um valor para este parâmetro, foi adicionado um valor GUID aleatório e utilizado como o valor da propriedade Nome para o Grupo do Microsoft 365 (Name_<RandomGUID>). Agora, o valor da propriedade Nome é preenchido pelo valor do parâmetro Alias e pelo valor da propriedade ExternalDirectoryObjectId (<Alias>_<ExternalDirectoryObjectId>).

Propriedades do parâmetro

Conjuntos de parâmetros

-Notes

Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local

O parâmetro Notas especifica a descrição do Grupo do Microsoft 365. Se o valor contiver espaços, coloque-o entre aspas.

Propriedades do parâmetro

Conjuntos de parâmetros

-Owner

Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local

O parâmetro Proprietário especifica o para o Grupo do Microsoft 365. Um proprietário é um membro do grupo que tem determinados privilégios, como a capacidade de editar propriedades do grupo.

O proprietário que você especifica para esse parâmetro deve ser um usuário com caixa de correio ou com permissões de email (uma entidade de segurança habilitada para email que pode ter permissões atribuídas). É possível usar qualquer valor que identifique o proprietário com exclusividade. Por exemplo:

• Nome
• Alias
• Nome diferenciado (DN)
• Nome diferenciado (DN)
• DN canônico
• GUID

Propriedades do parâmetro

Conjuntos de parâmetros

-PrimarySmtpAddress

Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local

O parâmetro PrimarySmtpAddress especifica o endereço de email de retorno principal que é usado para o destinatário. Não pode utilizar os parâmetros EmailAddresses e PrimarySmtpAddress no mesmo comando.

Propriedades do parâmetro

Conjuntos de parâmetros

-RequireSenderAuthenticationEnabled

Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local

O parâmetro RequireSenderAuthenticationEnabled especifica se pretende aceitar mensagens apenas de remetentes autenticados (internos). Os valores válidos são:

• $true: as mensagens são aceites apenas a partir de remetentes autenticados (internos). As mensagens de remetentes não autenticados (externos) são rejeitadas.
• $true: as mensagens são aceitas apenas de remetentes autenticados (internos). As mensagens de remetentes não autenticados (externos) são rejeitadas.

Propriedades do parâmetro

Conjuntos de parâmetros

-SensitivityLabelId

Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local

O parâmetro SensitivityLabelId especifica o valor GUID da etiqueta de confidencialidade atribuída ao Grupo do Microsoft 365.

Nota: na saída do cmdlet Get-UnifiedGroup, esta propriedade chama-se SensitivityLabel e não SensitivityLabelId.

Propriedades do parâmetro

Conjuntos de parâmetros

-SubscriptionEnabled

Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local

O comutador SubscriptionEnabled especifica se as subscrições de conversações e eventos de calendário estão ativadas para o Grupo do Microsoft 365. Não é preciso especificar um valor com essa opção.

Propriedades do parâmetro

Conjuntos de parâmetros

-SuppressWarmupMessage

Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local

Este parâmetro foi preterido e já não é utilizado.

Propriedades do parâmetro

Conjuntos de parâmetros

-WhatIf

Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local

A opção WhatIf simula as ações do comando. Você pode usar essa opção para exibir as alterações que ocorreriam sem realmente aplicar essas alterações. Não é preciso especificar um valor com essa opção.

Propriedades do parâmetro

Conjuntos de parâmetros

CommonParameters