Compartilhar via


New-AcceptedDomain

 

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

Tópico modificado em: 2008-11-13

Use o cmdlet New-AcceptedDomain para criar um novo domínio aceito 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.

Para obter mais informações sobre como configurar um domínio aceito, consulte Set-AcceptedDomain.

Sintaxe

New-AcceptedDomain -Name <String> -DomainName <SmtpDomainWithSubdomains> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-DomainType <Authoritative | ExternalRelay | InternalRelay>] [-TemplateInstance <PSObject>] [-WhatIf [<SwitchParameter>]]

Descrição detalhada

Para executar o cmdlet New-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

DomainName

Necessário

Microsoft.Exchange.Data.SmtpDomainWithSubdomains

A entrada válida para o parâmetro DomainName é um domínio SMTP. Insira o domínio SMTP que você deseja estabelecer como domínio aceito. Você pode usar um caractere curinga para especificar todos os subdomínios de um determinado domínio, conforme mostrado no seguinte exemplo: *.contoso.com.

Entretanto, não é possível incorporar um caractere curinga, conforme mostrado no seguinte exemplo: domain.*.contoso.com.

A cadeia de texto de nome do domínio não deve conter mais de 256 caracteres, incluindo o ponto que separa cada nível do nome do domínio. Por exemplo, um nome de domínio que tem um domínio de nível superior de três caracteres poderia conter 63 caracteres para cada um dos outros níveis: 63Caracteres.63Caracteres.63Caracteres.63Caracteres.com. Nesse exemplo, os 63 caracteres para quatro níveis, mais quatro pontos finais, mais as três letras "com" do nome de domínio de nível superior totalizam 256 caracteres.

Name

Necessário

System.String

Use este parâmetro para criar um nome exclusivo para o objeto do domínio aceito.

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ê somente na instância do Active Directory Application Mode (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, 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.

TemplateInstance

Opcional

System.Management.Automation.PSObject

Quando um objeto existente for fornecido para o parâmetro TemplateInstance, o comando usará a configuração desse objeto para criar uma cópia idêntica do objeto em um servidor local ou de destino.

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 de código a seguir cria um novo domínio aceito chamado Contoso. Para obter mais informações sobre como definir opções de configuração adicionais no objeto do domínio aceito, consulte Set-AcceptedDomain.

New-AcceptedDomain -DomainName Contoso.com -Name Contoso