Disable-DistributionGroup

  • Artigo

 

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

Tópico modificado em: 2007-06-22

Use o comando Disable-DistributionGroup para remover os recursos de email de um grupo habilitado para email.

Sintaxe

disable-DistributionGroup -Identity <DistributionGroupIdParameter> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Descrição detalhada

O comando Disable-DistributionGroup remove os atributos de email de um grupo. Ele não exclui o grupo.

Para executar o cmdlet Disable-DistributionGroup, 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 Microsoft Exchange Server 2007, consulte Considerações sobre permissão.

Parâmetros

Parâmetro Necessário(s) Tipo Descrição

Identity

Necessário(s)

Microsoft.Exchange.Configuration.Tasks.DistributionGroupIdParameter

O parâmetro Identity especifica a identidade do grupo de distribuição de uma das seguintes formas:

  • GUID

  • DN

  • LegacyExchangeDN

  • Domínio\NomedaConta

  • Alias

Confirm

Optional

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

Para especificar o FQDN (nome de domínio totalmente qualificado) do controlador de domínio que recupera dados do serviço de diretório do Active Directory, inclua o parâmetro DomainController no comando.

IgnoreDefaultScope

Optional

System.Management.Automation.SwitchParameter

O parâmetro IgnoreDefaultScope instrui o comando a ignorar a configuração de escopo do destinatário padrão do Shell de Gerenciamento do Exchange e usar toda a floresta como 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

Optional

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

Nesse exemplo, o comando Disable-DistributionGroup desabilita Distribution Group1.

Disable-DistributionGroup -Identity "Distribution Group1"