New-DistributionGroup

O parâmetro Alias especifica o alias do Exchange (também conhecido como apelido de email) para o destinatário. 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 do Alias pode conter letras, números e os seguintes caracteres:

• !, #, %, *, +, -, /, =, ?, ^, _, e ~.
• $, &, ', ', {, }e | precisam ser escapados (por exemplo -Alias what`'snew) ou todo o valor incluído em aspas individuais (por exemplo, -Alias 'what'snew'). O & caractere não tem suporte no valor do Alias para Azure AD Sincronização do Connect.
• Os períodos (.) devem ser cercados por outros caracteres válidos (por exemplo, help.desk).
• Caracteres unicode U+00A1 a U+00FF.

Quando você cria um destinatário sem especificar um endereço de email, o valor do Alias especificado é usado 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.

Se você não usar o parâmetro Alias ao criar um destinatário, o valor de um parâmetro necessário diferente será usado para o valor da propriedade Alias:

• Destinatários com contas de usuário (por exemplo, caixas de correio de usuário e usuários de email): o lado esquerdo do parâmetro MicrosoftOnlineServicesID ou UserPrincipalName é usado. Por exemplo, helpdesk@contoso.onmicrosoft.com resulta no valor helpdeskda propriedade Alias .
• Destinatários sem contas de usuário (por exemplo, caixas de correio de sala, contatos de email e grupos de distribuição): o valor do parâmetro Name é usado. Os espaços são removidos e caracteres sem suporte são convertidos em pontos de interrogação (?).

Se você modificar o valor do Alias de um destinatário existente, o endereço de email principal será atualizado automaticamente somente em ambientes em que o destinatário está sujeito a políticas de endereço de email (a propriedade EmailAddressPolicyEnabled é True para o destinatário).

O parâmetro Alias nunca gera ou atualiza o endereço de email principal de um contato de email ou de um usuário de email.

Este parâmetro está disponível somente no Exchange local.

O parâmetro ArbitrationMailbox especifica a caixa de correio de arbitragem que é usada para gerenciar o processo de moderação desse destinatário. É possível usar qualquer valor que identifique a caixa de correio de arbitragem exclusivamente. Por exemplo:

• Nome
• Alias
• Nome diferenciado (DN)
• Nome diferenciado (DN)
• Domain\username
• Endereço de email
• GUID
• LegacyExchangeDN
• SamAccountName
• ID de usuário ou nome UPN

Esse parâmetro só está disponível no serviço baseado em nuvem.

O parâmetro BccBlocked especifica se os membros do grupo não recebem mensagens se o grupo for usado na linha Bcc. Os valores válidos são:

• $true: se o grupo for usado na linha Bcc, os membros do grupo não receberão a mensagem e o remetente receberá um relatório de não entrega (também conhecido como NDR ou mensagem de retorno). Outros destinatários da mensagem não estão bloqueados. Se um remetente externo usar o grupo na linha Bcc, os membros do grupo não serão bloqueados. Para grupos aninhados, a mensagem é bloqueada apenas para membros do grupo de nível superior.
• $false: não há restrições para o uso do grupo na linha de mensagens do Bcc. Esse é o valor padrão.

O parâmetro ByPassNestedModerationEnabled especifica como lidar com a aprovação da mensagem quando um grupo moderado contém outros grupos moderados como membros. Os valores válidos são:

• $true: depois que um moderador aprova uma mensagem enviada ao grupo, a mensagem é aprovada automaticamente para todos os outros grupos moderados que são membros do grupo.
• $false: depois que um moderador aprova uma mensagem enviada ao grupo, a aprovação separada é necessária para cada grupo moderado que é membro do grupo. Esse é o valor padrão.

Esse parâmetro só pode ser usado por administradores de organização e locatários de nível superior.

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, cmdlets Remove-*) têm uma pausa interna que força você a reconhecer o comando antes de prosseguir. Para estes cmdlets, você pode pular o pedido de confirmação usando esta sintaxe exata: -Confirm:$false.
• A maioria dos outros cmdlets (por exemplo, cmdlets 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.

A opção CopyOwnerToMember especifica se os proprietários de grupo especificados pelo parâmetro ManagedBy também são membros do grupo. Não é preciso especificar um valor com essa opção.

Esse parâmetro só está disponível no serviço baseado em nuvem.

{{ Descrição de preenchimento }}

O parâmetro DisplayName especifica o nome de exibição do grupo. O nome de exibição está visível no centro de administração do Exchange e nas listas de endereços. O comprimento máximo é de 256 caracteres. Se o valor contiver espaços, coloque-o entre aspas (").

Se você não usa o parâmetro DisplayName, o valor do parâmetro Name é usado para o nome de exibição.

Se uma política de nomenclatura de grupo for imposta em sua organização, os usuários precisarão seguir as restrições de nomenclatura conforme especificado pelo parâmetro DistributionGroupNameBlockedWordList no cmdlet Set-OrganizationConfig. Para ignorar esse requisito, use a opção IgnoreNamingPolicy.

Este parâmetro está disponível somente no Exchange local.

O parâmetro DomainController especifica o controlador de domínio que é usado por esse cmdlet para ler dados ou gravar dados no Active Directory. Você identifica o controlador de domínio por seu FQDN (nome de domínio totalmente qualificado). Por exemplo, dc01.contoso.com.

Esse parâmetro só está disponível no serviço baseado em nuvem.

A opção HiddenGroupMembershipEnabled especifica se os membros do grupo de distribuição são ocultados de membros do grupo e usuários que não são membros do grupo. Não é preciso especificar um valor com essa opção.

Você pode usar essa configuração para ajudar a cumprir as regulamentações que exigem que você ocultar a associação de grupo de membros ou pessoas de fora (por exemplo, um grupo de distribuição que representa os alunos matriculados em uma classe).

Observação: não é possível alterar esta configuração após criar o grupo. Se você 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.

A opção IgnoreNamingPolicy especifica se esse grupo deve ser afetado pela política de nomenclatura de grupo da sua organização. Não é preciso especificar um valor com essa opção.

A política de nomenclatura de grupo é definida pelos parâmetros DistributionGroupNamingPolicy e DistributionGroupNameBlockedWordList no cmdlet Set-OrganizationConfig.

O parâmetro ManagedBy especifica um proprietário para o grupo. O grupo deve ter pelo menos um proprietário. Se você não usar esse parâmetro para especificar o proprietário ao criar o grupo, a conta de usuário que criou o grupo será o proprietário. O proprietário do grupo é capaz de:

• O parâmetro ManagedBy especifica um proprietário para o grupo. Um grupo deve ter pelo menos um proprietário. Se você não usar esse parâmetro para especificar o proprietário ao criar o grupo, a conta de usuário que criou o grupo será o proprietário. O proprietário do grupo é capaz de:
• Modificar as propriedades do grupo
• Adicionar ou remover membros do grupo
• Excluir o grupo
• Aprovar solicitações de entrada ou saída do membro (se disponível)

O proprietário especificado para esse parâmetro deve ser uma caixa de correio, um usuário de email ou um grupo de segurança habilitado para 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)
• Domain\username
• Endereço de email
• GUID
• LegacyExchangeDN
• SamAccountName
• ID de usuário ou nome UPN

Para inserir vários proprietários, use a seguinte sintaxe: Owner1,Owner2,...OwnerN. Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "Owner1","Owner2",..."OwnerN".

Os proprietários especificados com esse parâmetro não são adicionados automaticamente como membros do grupo. Use a opção CopyOwnerToMember ou adicione manualmente os proprietários como membros.

Observação: o gerenciamento de grupo no Outlook não funciona quando o proprietário é um grupo de segurança habilitado para email. Para gerenciar o grupo no Outlook, o proprietário deve ser uma caixa de correio ou um usuário de email.

O parâmetro MemberDepartRestriction especifica as restrições que você coloca em solicitações para deixar o grupo. Os valores válidos são:

• Aberto: os membros podem sair do grupo sem a aprovação de um dos proprietários do grupo. Esse é o valor padrão para grupos de distribuição universais. Você não pode usar esse valor em grupos de segurança universais.
• Open: os membros podem sair do grupo sem a aprovação de um dos proprietários do grupo. Esse é o valor padrão para grupos de distribuição universais. Este valor não pode ser usado em grupos de segurança universais.

O parâmetro MemberJoinRestriction especifica as restrições que você coloca em solicitações para ingressar no grupo. Os valores válidos são:

• Abrir: os usuários podem se adicionar ao grupo sem a aprovação de um proprietário de grupo. Você não pode usar esse valor em grupos de segurança universais.
• Fechado: os usuários não podem se adicionar ao grupo e as solicitações para ingressar no grupo são rejeitadas automaticamente. Esse é o valor padrão para grupos de distribuição universais. Esse é o valor padrão em grupos de segurança universais e grupos de distribuição universais.
• Closed: os usuários não podem adicionar a si mesmos no grupo, e as solicitações para ingressar no grupo serão automaticamente rejeitadas. O usuário é adicionado ao grupo após a solicitação ser aprovada por um dos proprietários do grupo. Este é o valor padrão em grupos de segurança universais e em grupos de distribuição universais.

O parâmetro Membros especifica os destinatários (objetos habilitados para email) que são membros do grupo. É 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".

Depois de criar o grupo, use o cmdlet Get-DistributionGroupMember para exibir os membros do grupo e os cmdlets Add-DistributionGroupMember, Remove-DistributionGroupMember e Update-DistributionGroupMember para gerenciar a associação ao grupo.

Embora não seja obrigatório, é uma boa ideia adicionar apenas entidades de segurança (por exemplo, caixas de correio e usuários de email com contas de usuário ou outros grupos de segurança habilitados para email) aos grupos de segurança habilitados para email. Se você atribuir permissões a um grupo de segurança habilitado para email, todos os membros que não forem entidades de segurança (por exemplo, contatos de email ou grupos de distribuição) não receberão as permissões.

O parâmetro ModeratedBy especifica um ou mais moderadores para esse grupo. Um moderador aprova mensagens enviadas ao grupo antes que as mensagens sejam entregues. Um moderador deve ser uma caixa de correio, um usuário de email ou um contato de email em sua organização. É possível usar qualquer valor que identifique o moderador exclusivamente. 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".

Para grupos de segurança habilitados para email, você precisa usar esse parâmetro para especificar pelo menos um moderador ao definir o parâmetro ModerationEnabled como o valor $true.

Para grupos de distribuição, se você definir o parâmetro ModerationEnabled como o valor $true, mas não usar esse parâmetro para especificar quaisquer moderadores, os proprietários do grupo especificados pelo parâmetro ManagedBy serão responsáveis pela aprovação das mensagens enviadas ao grupo.

O parâmetro ModerationEnabled especifica se a moderação está habilitada para esse destinatário. Os valores válidos são:

• $true: a moderação está habilitada para esse destinatário. As mensagens enviadas a esse destinatário devem ser aprovadas por um moderador antes que as mensagens sejam entregues.
• $false: A moderação está desabilitada para este destinatário. As mensagens enviadas a esse destinatário são entregues sem a aprovação de um moderador. Esse é o valor padrão.

Você usa o parâmetro ModeratedBy para especificar os moderadores.

O parâmetro Name especifica o nome exclusivo do grupo. O tamanho máximo é de 64 caracteres. Se o valor contiver espaços, coloque-o entre aspas (").

Esse valor também é usado para a propriedade DisplayName se você não usar o parâmetro DisplayName.

Os parâmetros Notes especificam informações adicionais sobre o objeto. Se o valor contiver espaços, coloque-o entre aspas (").

O parâmetro OrganizationalUnit especifica o local no Active Directory em que o grupo é criado.

A entrada válida para esse parâmetro é uma OU (unidade organizacional) ou domínio retornado pelo cmdlet Get-OrganizationalUnit. É possível usar qualquer valor que identifique a UO ou o domínio com exclusividade. Por exemplo:

• Nome
• Nome
• Nome diferenciado (DN)
• GUID

O parâmetro PrimarySmtpAddress especifica o endereço de email de retorno principal que é usado para o destinatário.

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

• $true: as mensagens são aceitas somente de remetentes autenticados (internos). 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.

O valor padrão é $true.

A opção RoomList especifica que todos os membros desse grupo de distribuição são caixas de correio de sala. Não é necessário especificar um valor com essa opção.

Você pode criar um grupo de distribuição para um edifício comercial em sua organização e adicionar todos as salas nesse edifício ao grupo de distribuição. Grupos de distribuição de lista de salas são usados para gerar uma lista de locais de construção para solicitações de reunião no Outlook 2010 ou posterior. As listas de sala permitem que um usuário selecione um edifício e obtenha informações de disponibilidade de sala de todas as salas do edifício sem precisar adicionar cada sala individualmente.

Este parâmetro está disponível somente no Exchange local.

O parâmetro SamAccountName (também conhecido como conta de usuário ou nome de grupo pré-Windows 2000) especifica um identificador de objeto compatível com versões mais antigas dos sistemas operacionais cliente e servidor do Microsoft Windows. O valor pode conter letras, números, espaços, períodos (.) e os seguintes caracteres: !, #, $, %, ^, , &-, _, {, }e ~. O último caractere não pode ser um período. Caracteres unicode são permitidos, mas caracteres acentuados podem gerar colisões (por exemplo, o e ö match). O comprimento máximo é de 20 caracteres.

As conexões do cliente são feitas por proxy dos serviços de Acesso para Cliente para os serviços de back-end nos servidores de Caixa de Correio locais ou remotos. Os valores válidos são:

• Sempre: notifique todos os remetentes quando as mensagens não forem aprovadas. Esse é o valor padrão.
• Always: notificar todos os remetentes quando suas mensagens não forem aprovadas. Este é o valor padrão.
• Internal: notificar remetentes da organização quando as mensagens não forem aprovadas.

Esse parâmetro só é significativo quando a moderação é habilitada (o parâmetro ModerationEnabled tem o valor $true).

O parâmetro Type especifica o tipo de grupo que você deseja criar. Os valores válidos são:

• Distribuição: um grupo de distribuição. Esses grupos não podem ter permissões atribuídas. Esse é o valor padrão.
• Segurança: um grupo de segurança habilitado para email. Esses grupos podem ter permissões atribuídas.

O escopo do grupo é sempre Universal.

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.