New-DistributionGroup

  • Artigo

 

Aplica-se a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Tópico modificado em: 2009-05-12

Use o cmdlet New-DistributionGroup para criar um novo grupo de distribuição.

Sintaxe

New-DistributionGroup -Name <String> -SamAccountName <String> -Type <Distribution | Security> [-Alias <String>] [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DomainController <Fqdn>] [-ManagedBy <GeneralRecipientIdParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-TemplateInstance <PSObject>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]

Descrição detalhada

Você pode usar o cmdlet New-DistributionGroup para criar novos objetos do grupo do Active Directory dos seguintes tipos:

  • Grupo de segurança universal habilitado para email

  • Grupo de distribuição universal

Grupos de distribuição são usados para consolidar grupos de destinatários em um único ponto de contato para mensagens de email. Os grupos de distribuição não podem ser usados para atribuir permissões a recursos de rede no serviço de diretório do Active Directory.

Para executar o cmdlet New-DistributionGroup, você deve usar uma conta à qual esteja delegado o seguinte:

  • Função Administrador de Destinatários do Exchange

  • Função de Operador de Conta para os contêineres aplicáveis do Active Directory

Para obter mais informações sobre permissões, delegação de funções e os direitos necessários para administrar o Exchange Server 2007, consulte Considerações sobre permissão.

Parâmetros

Parâmetro Necessário Tipo Descrição

Name

Necessário

System.String

Esse parâmetro especifica o nome do novo grupo de distribuição. O valor especificado no parâmetro Name também será usado para DisplayName se o parâmetro DisplayName não for especificado.

O valor Name não pode exceder 64 caracteres.

Se os valores de Name e DisplayName forem diferentes:

  • Name especifica o nome do grupo de distribuição em Usuários e Computadores do Active Directory e também no campo Nome do Grupo no Console de Gerenciamento do Exchange.

  • DisplayName especifica o nome do grupo de distribuição no Console de Gerenciamento do Exchange e na GAL (lista de endereços global) do Exchange.

SamAccountName

Necessário

System.String

Esse parâmetro especifica o nome para clientes do objeto que estão executando sistemas operacionais mais antigos. O parâmetro SamAccountName é exibido no Active Directory e no Console de Gerenciamento do Exchange no campo Nome do grupo (antes do Windows 2000). Se o parâmetro Alias não estiver especificado, as seguintes condições serão verdadeiras:

  • O valor de SAMAccountName é usado para o valor do parâmetro Alias com todos os espaços convertidos em sublinhados.

  • SAMAccountName, com todos os espaços convertidos em sublinhados, é usado para gerar o endereço de email SMTP (Simple Mail Transfer Protocol) principal do objeto.

Type

Necessário

Microsoft.Exchange.Management.RecipientTasks.GroupType

Esse parâmetro especifica o tipo de grupo que será criado no Active Directory. O escopo do grupo é sempre Universal. Os valores válidos são Distribution ou Security.

Alias

Opcional

System.String

Esse parâmetro pode ser usado para especificar o alias do grupo de distribuição. O parâmetro Alias é usado para gerar o endereço de email SMTP principal do objeto. O valor de Alias não pode conter espaços. Se Alias não for especificado, o valor de SAMAccountName será usado para gerar o endereço de email SMTP principal, com todos os espaços convertidos em sublinhados.

Confirm

Opcional

System.Management.Automation.SwitchParameter

O parâmetro Confirm faz com que o comando pause o processamento e exige que você confirme o que o comando fará antes que o processamento continue. Você não precisa especificar um valor com o parâmetro Confirm.

DisplayName

Opcional

System.String

Esse parâmetro pode ser usado para especificar o nome do grupo de distribuição no Console de Gerenciamento do Exchange e na GAL do Exchange. Se o parâmetro DisplayName não for especificado, o valor do parâmetro Name será usado para DisplayName.

DomainController

Opcional

Microsoft.Exchange.Data.Fqdn

Para especificar o nome de domínio totalmente qualificado (FQDN) do controlador de domínio que grava essa alteração de configuração no Active Directory, inclua o parâmetro DomainController.

ManagedBy

Opcional

Microsoft.Exchange.Configuration.Tasks.GeneralRecipientIdParameter

Esse parâmetro pode ser usado para especificar o nome do usuário da caixa de correio, o grupo habilitado para email ou o contato habilitado para email que é exibido na guia Gerenciado por do objeto do Active Directory. Você pode usar qualquer um dos valores a seguir para este parâmetro:

  • DN (nome distinto)

  • Nome canônico

  • GUID

  • Name

  • Nome para exibição

  • DN Herdado do Exchange

  • Endereço de email SMTP principal

OrganizationalUnit

Opcional

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

Esse parâmetro especifica onde criar o grupo de distribuição no Active Directory com a sintaxe de nome canônico.

TemplateInstance

Opcional

System.Management.Automation.PSObject

Quando um objeto existente for fornecido para este parâmetro, o cmdlet usará esse objeto para criar uma cópia do objeto.

UseRusServer

Opcional

System.String
noteObservação:
Este parâmetro está disponível somente no Exchange Server 2007 SP2.

O parâmetro UseRusServer instrui o comando para usar o servidor de Caixa de Correio especificado em que o serviço Lista de Endereços está sendo executado para obter e definir atributos de caixa de correio e de usuário do Active Directory.

O serviço Lista de Endereços é um componente no serviço Atendedor do Sistema Exchange. Esse serviço cria e mantém valores de atributos específicos do Exchange no Active Directory. Você pode usar o serviço Lista de Endereços para atualizar objetos de destinatário em um domínio usando informações específicas, como associação da lista de endereços e endereços de email.

WhatIf

Opcional

System.Management.Automation.SwitchParameter

O parâmetro WhatIf instrui o comando a simular as ações que ele executará no objeto. Ao usar o parâmetro WhatIf, você poderá exibir quais alterações ocorrerão sem precisar aplicar nenhuma dessas alterações. Você não precisa especificar um valor com o parâmetro WhatIf.

Tipos de entrada

Tipos de retorno

Erros

Erro Descrição

 

 

Exceções

Exceções Descrição

 

 

Exemplo

O exemplo de código a seguir mostra como usar o cmdlet New-DistributionGroup para criar um novo grupo de segurança habilitado para email que tenha os seguintes parâmetros:

  • O nome do grupo será "Managers".

  • O grupo será criado no contêiner Users do domínio Contoso.com.

  • O nome da conta de SAM do grupo será "Managers".

  • O tipo de grupo será Security.

New-DistributionGroup -Name "Managers" -OrganizationalUnit "contoso.com/Users" -SAMAccountName "Managers" -Type "Security"