Este artigo foi traduzido por máquina. Para visualizar o arquivo em inglês, marque a caixa de seleção Inglês. Você também pode exibir o texto Em inglês em uma janela pop-up, movendo o ponteiro do mouse sobre o texto.
Tradução
Inglês

New-DistributionGroup

 

Aplica-se a:Exchange Online, Exchange Server 2016

Tópico modificado em:2018-01-11

Este cmdlet está disponível no Exchange local e no serviço baseado na nuvem. Alguns parâmetros e configurações podem ser exclusivos de um ou outro ambiente.

Use o cmdlet New-DistributionGroup para criar grupos de distribuição ou grupos de segurança habilitados para email.

Para obter informações sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte SintaxeSintaxe de cmdlet do Exchange.

New-DistributionGroup -Name <String> [-Alias <String>] [-ArbitrationMailbox <MailboxIdParameter>] [-BypassNestedModerationEnabled <$true | $false>] [-Confirm [<SwitchParameter>]] [-CopyOwnerToMember <SwitchParameter>] [-DisplayName <String>] [-DomainController <Fqdn>] [-ExternalDirectoryObjectId <String>] [-IgnoreNamingPolicy <SwitchParameter>] [-ManagedBy <MultiValuedProperty>] [-MemberDepartRestriction <Closed | Open | ApprovalRequired>] [-MemberJoinRestriction <Closed | Open | ApprovalRequired>] [-Members <MultiValuedProperty>] [-ModeratedBy <MultiValuedProperty>] [-ModerationEnabled <$true | $false>] [-Notes <String>] [-Organization <OrganizationIdParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-OverrideRecipientQuotas <SwitchParameter>] [-PrimarySmtpAddress <SmtpAddress>] [-RequireSenderAuthenticationEnabled <$true | $false>] [-RoomList <SwitchParameter>] [-SamAccountName <String>] [-SendModerationNotifications <Never | Internal | Always>] [-Type <Distribution | Security>] [-WhatIf [<SwitchParameter>]]

Este exemplo cria um grupo de segurança habilitado para email, chamado Gerentes, sem especificar nenhum membro.

New-DistributionGroup -Name Managers"Managers" -Type "Security"

Você usa o cmdlet Add-DistributionGroupMember para adicionar membros depois de criar o grupo.

Este exemplo cria um grupo de distribuição chamado ITDepartment e especifica os membros.

New-DistributionGroup -Name "ITDepartment" -Members chris@contoso.com,michelle@contoso.com,laura@contoso.com,julia@contoso.com

Use o cmdlet New-DistributionGroup para criar os seguintes tipos de grupos:

  • Grupos de segurança universais habilitados para email (USGs)

  • Grupos de distribuição universais

Grupos de distribuição são usados para consolidar grupos de destinatários em um único ponto de contato ara mensagens de email. Grupos de distribuição não são entidades de segurança e, portanto, não podem receber permissões. No entanto, você pode atribuir permissões a grupos de segurança habilitados para email.

Para executar esse cmdlet, você precisa ter permissões. Embora todos os parâmetros para este cmdlet estejam listados neste tópico, talvez você não tenha acesso a alguns parâmetros, caso eles não estejam incluídos nas permissões atribuídas a você. Para ver de que permissões você precisa, consulte o Entrada "Grupos de distribuição" no tópico Permissões de destinatários.

 

Parâmetro Obrigatório Tipo Descrição

Nome

Obrigatório

System.String

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.

noteObservação:
Se uma política de nomenclatura de grupo for aplicada, é necessário seguir as restrições de nomenclatura especificadas nos parâmetros DistributionGroupNameBlockedWordList e DistributionGroupNamingPolicy do cmdlet Set-OrganizationConfig.

Alias

Opcional

System.String

O parâmetro Alias especifica o alias Exchange (também conhecido como o apelido do 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 proxy). Um destinatário pode ter apenas um valor Alias.

O valor de Alias pode conter letras, números e os caracteres !, #, $, %, &, ', *, +, -, /, =, ?, ^, _, `, {, |, } e ~. Pontos (.) são permitidos, mas cada ponto deve estar cercado por outros caracteres válidos (por exemplo, help.desk). Caracteres Unicode de U+00A1 a U+00FF também são permitidos. O comprimento máximo do valor Alias é 64 caracteres.

Quando você cria um destinatário sem especificar um endereço de email, o valor Alias especificado é usado para gerar o endereço de email principal (<alias>@<domain>). Os caracteres Unicode compatíveis são mapeados para melhor ajuste dos 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 obrigatório diferente será usado para o valor da propriedade Alias:

  • Destinatários com contas de usuário (por exemplo, caixas de correio do usuário e usuários de email)   O lado esquerdo do parâmetro MicrosoftOnlineServicesID ou UserPrincipalName será usado. Por exemplo, helpdesk@contoso.com resulta no valor da propriedade Aliashelpdesk.

  • Destinatários sem contas de usuários (por exemplo, caixas de correio de sala, contatos de email e grupos de distribuição)   O valor do parâmetro Name será usado. Os espaços são removidos e os caracteres incompatíveis são convertidos em pontos de interrogação (?).

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

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

ArbitrationMailbox

Opcional

Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter

Esse parâmetro está disponível somente em Exchange locais.

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

  • Nome para exibição

  • Alias

  • Nome diferenciado (DN)

  • DN canônico

  • <domain name>\<account name>

  • Endereço de email

  • GUID

  • LegacyExchangeDN

  • SamAccountName

  • ID de usuário ou nome UPN

BypassNestedModerationEnabled

Opcional

System.Boolean

O parâmetro ByPassNestedModerationEnabled especifica como manipular a aprovação de 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 grupos moderados que são membros do grupo.

  • $false   Depois que um moderador aprova uma mensagem enviada ao grupo, é exigida uma aprovação separada para cada grupo moderado que seja um membro do grupo. Esse é o valor padrão.

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

Confirm

Opcional

System.Management.Automation.SwitchParameter

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 confirmar o comando antes de continuar. Para esses cmdlets, você pode ignorar a solicitação 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.

CopyOwnerToMember

Opcional

System.Management.Automation.SwitchParameter

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.

DisplayName

Opcional

System.String

O parâmetro DisplayName especifica o nome de exibição do grupo. O nome de exibição fica visível no Centro de administração do Exchange e nas listas de endereços. O tamanho 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.

DomainController

Opcional

Microsoft.Exchange.Data.Fqdn

Esse parâmetro está disponível somente em Exchange locais.

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.

ExternalDirectoryObjectId

Opcional

System.String

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

IgnoreNamingPolicy

Opcional

System.Management.Automation.SwitchParameter

A opção IgnoreNamingPolicy especifica se é necessário impedir que esse grupo seja afetado pela política de nomenclatura de grupo de distribuição de sua organização. A política é definida pelo parâmetro DistributionGroupNamingPolicy no cmdlet Set-OrganizationConfig. Não é preciso especificar um valor com essa opção.

ManagedBy

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

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)

  • Aprovar mensagens enviadas ao grupo se a moderação estiver habilitada, mas nenhum moderador estiver especificado.

O proprietário que você especifica 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

  • Nome para exibição

  • Alias

  • Nome diferenciado (DN)

  • DN canônico

  • <domain name>\<account name>

  • Endereço de email

  • GUID

  • LegacyExchangeDN

  • SamAccountName

  • ID de usuário ou nome UPN

Para inserir vários proprietários e substituir todas as entradas existentes, use a seguinte sintaxe: <owner1>,<owner2>.... Se os valores contiverem espaços ou exigirem aspas, será necessário usar a seguinte sintaxe: "<owner1>","<owner2>"....

Para adicionar ou remover proprietários sem afetar outras entradas existentes, use a seguinte sintaxe: @{Add="<owner1>","<owner2>"...; Remove="<owner3>","<owner4>"...}.

Um proprietário que você especifica com esse parâmetro não é automaticamente um membro do grupo. Você precisa adicionar manualmente o proprietário como um membro.

Como alternativa, você pode usar a opção CopyOwnerToMember para que os proprietários virem membros do grupo automaticamente.

MemberDepartRestriction

Opcional

Microsoft.Exchange.Data.Directory.Recipient.MemberUpdateType

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

  • 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. Esse valor não pode ser usado em grupos de segurança universais.

  • Closed   Os membros não podem se remover do grupo e as solicitações para sair do grupo serão automaticamente rejeitadas. A associação a um grupo é controlada pelos proprietários do grupo. Este é o valor padrão para grupos de segurança universais.

MemberJoinRestriction

Opcional

Microsoft.Exchange.Data.Directory.Recipient.MemberUpdateType

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

  • Open   Os usuários podem adicionar a si mesmos ao grupo sem a aprovação de um proprietário do grupo. Esse valor não pode ser usado em grupos de segurança 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. A associação a um grupo é controlada pelos proprietários do grupo. Este é o valor padrão em grupos de segurança universais e em grupos de distribuição universais.

  • ApprovalRequired   Os usuários podem solicitar o ingresso no grupo. O usuário será adicionado ao grupo depois que a solicitação for aprovada por um dos proprietários do grupo. Embora seja possível usar esse valor em grupos de segurança universais, as solicitações de usuários para ingressar no grupo não serão enviadas aos proprietários do grupo, portanto, esta configuração só é eficaz em grupos de distribuição universal.

Members

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

O parâmetro Members 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

  • Nome para exibição

  • Alias

  • Nome diferenciado (DN)

  • DN canônico

  • Endereço de email

  • GUID

Para inserir diversos valores e substituir quaisquer entradas existentes, use a seguinte sintaxe: <value1>,<value2>.... Se os valores contiverem espaços ou exigirem aspas, será necessário usar a seguinte sintaxe: "<value1>","<value2>"....

Para adicionar ou remover um ou mais valores sem afetar nenhuma entrada existente, use a seguinte sintaxe: @{Add="<value1>","<value2>"...; Remove="<value1>","<value2>"...}.

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

noteObservação:
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.

ModeratedBy

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

O parâmetro ModeratedBy especifica um ou mais moderadores para esse grupo. Um moderador aprova as mensagens enviadas para o 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 com exclusividade.

Por exemplo:

  • Nome

  • Nome para exibição

  • Alias

  • Nome diferenciado (DN)

  • DN canônico

  • Endereço de email

  • GUID

Para inserir diversos valores e substituir quaisquer entradas existentes, use a seguinte sintaxe: <value1>,<value2>.... Se os valores contiverem espaços ou exigirem aspas, será necessário usar a seguinte sintaxe: "<value1>","<value2>"....

Para adicionar ou remover um ou mais valores sem afetar nenhuma entrada existente, use a seguinte sintaxe: @{Add="<value1>","<value2>"...; Remove="<value1>","<value2>"...}.

Para grupos de segurança habilitados para email, você precisará usar esse parâmetro para especificar pelo menos um moderador quando você define 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 você não usar esse parâmetro para especificar qualquer moderadores, os proprietários do grupo que são especificados pelo parâmetro ManagedBy são responsáveis por aprovar mensagens enviadas para o grupo.

ModerationEnabled

Opcional

System.Boolean

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 de serem entregues.

  • $false   A moderação está desabilitada para esse destinatário. As mensagens enviadas a esse destinatário são entregues sem a aprovação de um moderador. Esse é o valor padrão.

Use o parâmetro ModeratedBy para especificar os moderadores.

Notes

Opcional

System.String

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

Organization

Opcional

Microsoft.Exchange.Configuration.Tasks.OrganizationIdParameter

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

OrganizationalUnit

Opcional

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

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

A entrada válida para esse parâmetro é uma UO (unidade organizacional) ou um domínio que fique visível na utilização do cmdlet Get-OrganizationalUnit. É possível usar qualquer valor que identifique a UO ou o domínio com exclusividade. Por exemplo:

  • Nome

  • Nome canônico

  • Nome diferenciado (DN)

  • GUID

OverrideRecipientQuotas

Opcional

System.Management.Automation.SwitchParameter

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

PrimarySmtpAddress

Opcional

Microsoft.Exchange.Data.SmtpAddress

O parâmetro PrimarySmtpAddress especifica o endereço de email de retorno principal que é usado para o destinatário. Se estiver disponível neste cmdlet, você não poderá usar os parâmetros EmailAddresses e PrimarySmtpAddress no mesmo comando.

RequireSenderAuthenticationEnabled

Opcional

System.Boolean

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

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

  • $false   As mensagens são aceitas de remetentes autenticados (internos) e não autenticados (externos).

O valor padrão é $true.

RoomList

Opcional

System.Management.Automation.SwitchParameter

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. Os grupos de distribuição da lista de salas são usados para gerar uma lista de locais em edifícios 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.

SamAccountName

Opcional

System.String

Esse parâmetro está disponível somente em Exchange locais.

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

SendModerationNotifications

Opcional

Microsoft.Exchange.Data.Directory.Recipient.TransportModerationNotificationFlags

O parâmetro SendModerationNotifications especifica quando as mensagens de notificação de moderação são enviadas. Os valores válidos sã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.

  • Never   Não notificar ninguém quando uma mensagem não for aprovada.

Este parâmetro será significativo apenas quando a moderação for habilitada (o parâmetro ModerationEnabled tem valor $true).

Tipo

Opcional

Microsoft.Exchange.Management.RecipientTasks.GroupType

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

  • Um grupo de distribuição. Não é possível atribuir permissões para esses grupos. Este é o valor padrão.

  • Um grupo de segurança habilitado para email. É possível atribuir permissões para esses grupos.

O escopo do grupo é sempre Universal.

WhatIf

Opcional

System.Management.Automation.SwitchParameter

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.

Para ver os tipos de entrada que este cmdlet aceita, confira Tipos de entrada e saída de cmdlet. Se o campo Tipo de Entrada de um cmdlet estiver em branco, isso significa que o cmdlet não aceita dados de entrada.

Para ver os tipos de retorno, também conhecidos como tipos de saída, que este cmdlet aceita, consulte Tipos de entrada e saída de cmdlet. Se o campo Tipo de Saída estiver em branco, o cmdlet não retorna dados.

 
Mostrar: