Remove-DynamicDistributionGroup

  • Artigo

 

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

Tópico modificado em: 2007-09-27

Use o cmdlet Remove-DynamicDistributionGroup para excluir um grupo dinâmico de distribuição existente.

Sintaxe

Remove-DynamicDistributionGroup -Identity <DynamicGroupIdParameter> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Descrição detalhada

Você pode usar o cmdlet Remove-DynamicDistributionGroup para excluir um grupo dinâmico de distribuição existente.

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

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

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

Identity

Necessário

Microsoft.Exchange.Configuration.Tasks.DynamicGroupIdParameter

O parâmetro Identity é usado para identificar o grupo dinâmico de distribuição que você deseja remover. O parâmetro Identity pode obter qualquer um dos seguintes valores para o grupo dinâmico de distribuição:

  • DN (nome distinto)

  • Nome canônico

  • GUID

  • Nome

  • Nome para exibição

  • Alias

  • DN Herdado do Exchange

  • Endereço de email SMTP principal

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.

DomainController

Opcional

Microsoft.Exchange.Data.Fqdn

O parâmetro DomainController especifica o nome de domínio totalmente qualificado do controlador de domínio que grava essa alteração de configuração no serviço de diretório do Active Directory.

IgnoreDefaultScope

Opcional

System.Management.Automation.SwitchParameter

O parâmetro IgnoreDefaultScope instrui o comando a ignorar a configuração padrão de escopo do destinatário do Shell de Gerenciamento do Exchange e usar toda a floresta como o escopo. Isso permite que o comando acesse objetos do Active Directory que não estão atualmente no escopo padrão. O uso do parâmetro IgnoreDefaultScope introduz as seguintes restrições:

  • Você não pode usar o parâmetro DomainController. O comando usará automaticamente um servidor de catálogo global adequado.

  • Você pode usar o DN somente para o parâmetro Identity. Outras formas de identificação, como alias ou GUID, não são aceitas.

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 Remove-DynamicDistributionGroup para excluir um grupo dinâmico de distribuição chamado Test Users usando seu nome.

Remove-DynamicDistributionGroup -Identity "Test Users"