Set-AcceptedDomain

  • Artigo

 

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

Tópico modificado em: 2009-08-28

Use o cmdlet Set-AcceptedDomain para configurar um domínio aceito existente em sua organização. Um domínio aceito é qualquer namespace SMTP para o qual uma organização do Exchange envia e recebe emails. Os domínios aceitos incluem aqueles domínios para os quais a organização do Exchange é autoritativa. Uma organização do Exchange é autoritativa quando controla a entrega de mensagens para destinatários no domínio aceito. Os domínios aceitos também incluem domínios para os quais a organização do Exchange recebe emails e, em seguida, retransmite para um servidor de email que está fora da floresta do Active Directory para entrega ao destinatário.

Sintaxe

Set-AcceptedDomain -Identity <AcceptedDomainIdParameter> [-AddressBookEnabled <$true | $false>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-DomainType <Authoritative | ExternalRelay | InternalRelay>] [-MakeDefault <$true | $false>] [-Name <String>] [-WhatIf [<SwitchParameter>]]

Set-AcceptedDomain [-AddressBookEnabled <$true | $false>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-DomainType <Authoritative | ExternalRelay | InternalRelay>] [-Instance <AcceptedDomain>] [-MakeDefault <$true | $false>] [-Name <String>] [-WhatIf [<SwitchParameter>]]

Descrição detalhada

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

  • Função Administrador da Organização 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 Tipo Descrição

Identity

Necessário

Microsoft.Exchange.Configuration.Tasks.AcceptedDomainIdParameter

Use esse parâmetro para especificar um valor de cadeia de caracteres para o domínio aceito. Digite a GUID ou o nome exclusivo definido no parâmetro Name do objeto de domínio aceito.

AddressBookEnabled

Opcional

System.Boolean

Use esse parâmetro para habilitar a filtragem de destinatários na função de servidor Transporte de Borda que aceita emails para esse domínio aceito. Você deverá definir esse parâmetro como $true somente se todos os destinatários desse domínio aceito estiverem replicados para a instância do ADAM (Active Directory Application Mode) de Borda na qual a filtragem de destinatários for executada para esse domínio aceito. Os valores padrão desse parâmetro são os seguintes:

  • Para domínios autoritativos: $true

  • Para domínios de retransmissão internos: $false

  • Para domínios de retransmissão externos: $false

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 nome de domínio totalmente qualificado (FQDN) do controlador de domínio que grava essas informações de configuração no serviço de diretório Active Directory, inclua o parâmetro DomainController no comando. O parâmetro DomainController não tem suporte em computadores em que a função de servidor Transporte de Borda está instalada. A função de servidor Transporte de Borda grava e lê apenas na instância local do ADAM.

DomainType

Opcional

Microsoft.Exchange.Data.Directory.SystemConfiguration.AcceptedDomainType

Use este parâmetro para definir o tipo de domínio aceito que deseja configurar. Os valores válidos são Authoritative, InternalRelay e ExternalRelay. Você deve definir pelo menos um valor.

Em um domínio autoritativo, as mensagens são enviadas para um destinatário que possui uma conta de domínio em sua organização do Exchange. Em um domínio de retransmissão interno, as mensagens são retransmitidas para um servidor que está fora da sua organização do Exchange, mas ainda sob a autoridade de sua empresa ou departamento de TI. Use o domínio de retransmissão interno se desejar tratar as mensagens para esse domínio como mensagens internas. Em um domínio de retransmissão externo, as mensagens são retransmitidas para um servidor de email fora da organização, sobre o qual você não tem controle.

O valor padrão é Authoritative.

Instance

Opcional

Microsoft.Exchange.Data.Directory.SystemConfiguration.AcceptedDomain

Use esse parâmetro para passar um objeto inteiro para o comando para ser processado. Ele é usado principalmente quando um objeto inteiro deve ser passado para o comando.

MakeDefault

Opcional

System.Boolean

Use esse parâmetro para especificar se o domínio aceito é o domínio padrão. O domínio aceito padrão é o nome de domínio associado às mensagens de saída que possuem endereços encapsulados, como IMCEANOTES-user+40OtherSystem@contoso.com, para interoperabilidade com sistemas de email não Exchange. Se você não precisar interoperar com um sistema de email não Exchange na organização, não será necessário definir esse parâmetro. Para o primeiro domínio aceito criado na organização, o valor padrão é $true. Para domínios aceitos subseqüentes, o valor padrão é $false.

Name

Opcional

System.String

Use este parâmetro para criar um nome único para o objeto de domínio remoto.

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.

Exemplo

O exemplo a seguir, mostra como usar o cmdlet Set-AcceptedDomain para configurar um domínio aceito, Contoso, como padrão.

Set-AcceptedDomain -Identity Contoso -MakeDefault:$true