New-RemoteDomain
Aplica-se a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Tópico modificado em: 2007-07-18
Use o cmdlet New-RemoteDomain para criar uma conexão gerenciada para um domínio remoto. Ao criar um domínio remoto, você poderá controlar o fluxo de mensagens com mais precisão, aplicar formatação e diretivas de mensagens e especificar conjuntos de caracteres aceitáveis para mensagens que são enviadas para o domínio remoto e recebidas dele.
Para obter mais informações sobre como configurar o domínio remoto, consulte Set-RemoteDomain.
Sintaxe
New-RemoteDomain -Name <String> -DomainName <SmtpDomainWithSubdomains> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-TemplateInstance <PSObject>] [-WhatIf [<SwitchParameter>]]
Descrição detalhada
Para executar o cmdlet New-RemoteDomain, 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 |
|---|---|---|---|
Confirm |
Optional |
System.Management.Automation.SwitchParameter |
O parâmetro Confirm faz com que o comando pause o processamento e exige que o administrador confirme o que o comando fará antes que o processamento continue. O valor padrão é |
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). |
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 remoto. Você pode usar um caractere curinga para especificar todos os subdomínios de um determinado domínio, conforme mostrado no seguinte exemplo: |
Name |
Necessário |
System.String |
Use o parâmetro Name para criar um nome exclusivo para o objeto de domínio remoto. |
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, o administrador poderá exibir quais alterações ocorrerão sem precisar aplicar nenhuma dessas alterações. O valor padrão é |
Exemplo
Os exemplos a seguir mostram como usar o cmdlet New-RemoteDomain para criar uma conexão gerenciada para um domínio remoto.
O primeiro exemplo mostra como criar um novo domínio remoto denominado Contoso.
O segundo exemplo mostra como criar um novo domínio remoto denominado Adatum. No cmdlet Set-RemoteDomain, o parâmetro AllowedOOFType é definido como None e o parâmetro DisplaySenderName é definido como $False no Adatum. Em seguida, o Adatum é atribuído a uma variável chamada $Example. A variável $Example passa pelo parâmetro TemplateInstance quando um novo domínio remoto chamado Contoso é criado. Isso cria uma cópia exata do objeto de domínio remoto do Adatum em Contoso. Como o parâmetro TemplateInstance cria uma cópia exata do objeto de domínio remoto, os valores dos parâmetros AllowedOOFType e DisplaySenderName em Contoso correspondem aos valores do Adatum.
Para obter mais informações sobre como definir opções de configuração adicionais em um objeto de domínio remoto, consulte Set-RemoteDomain. Para obter mais informações sobre como exibir informações de configuração de objetos de domínio remoto em sua organização, consulte Get-RemoteDomain.
New-RemoteDomain -DomainName Contoso.com -Name Contoso
New-RemoteDomain -DomainName Adatum.com -Name Adatum
Set-RemoteDomain Adatum -AllowedOOFType None -DisplaySenderName $False
$Example = Get-RemoteDomain Adatum
New-RemoteDomain -DomainName Contoso.com -Name Contoso -TemplateInstance $Example