Compartilhar via

New-ForeignConnector

  • Artigo

 

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-ForeignConnector para criar um novo conector estrangeiro em um computador que esteja executando o Microsoft Exchange Server 2007 e que tenha a função de servidor Transporte de Hub instalada. Um Conector estrangeiro usa um Diretório de recebimento em um servidor de Transporte de Hub para enviar mensagens a um servidor de mensagem local que não use o SMTP como mecanismo de transporte principal. Esses servidores de mensagens são conhecidos como servidores de gateway externos. Servidores gateway de fax de terceiros são exemplos de servidores gateway externos. Os espaços de endereçamento atribuídos a um conector Externo podem ser SMTP ou não-SMTP.

Sintaxe

New-ForeignConnector -Name <String> -AddressSpaces <MultiValuedProperty> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-IsScopedConnector <$true | $false>] [-SourceTransportServers <MultiValuedProperty>] [-TemplateInstance <PSObject>] [-WhatIf [<SwitchParameter>]]

Descrição detalhada

O cmdlet New-ForeignConnector cria um novo conector estrangeiro. Para que sejam solicitados os parâmetros necessários de um novo conector estrangeiro, digite New-ForeignConnector. Depois que essa tarefa for concluída, o conector estrangeiro será criado.

Dica

Depois de criar um novo conector Externo, reinicie o serviço de Transporte do Microsoft Exchange (MSExchangeTransport) para que as alterações entrem em vigor.

Para executar o cmdlet New-ForeignConnector, você deve usar uma conta à qual esteja delegada a função Administrador do Exchange Server e o grupo Administradores local do servidor de destino.

Para obter mais informações sobre permissões, delegação de funções e os direitos necessários para administrar o Exchange 2007, consulte Considerações sobre permissão. 

Parâmetros

Parâmetro Necessário Tipo Descrição

AddressSpaces

Necessário

Microsoft.Exchange.Data.MultiValuedProperty

Esse parâmetro especifica os nomes de domínio aos quais o conector estrangeiro envia mensagens. A sintaxe completa para inserir cada espaço de endereçamento é a seguinte: <AddressSpaceType>:<AddressSpace>;<AddressSpaceCost>

  • AddressSpaceType   O tipo de espaço de endereçamento pode ser SMTP, X400 ou qualquer outra cadeia de caracteres de texto. Se você omitir o tipo de espaço de endereçamento, será usado o tipo de espaço de endereçamento SMTP.

  • AddressSpace   Para tipos de espaço de endereçamento SMTP, o espaço de endereçamento que você inserir deve ser compatível com RFC 1035. Por exemplo, *, *.com e *.contoso.com são permitidos, mas *contoso.com não é permitido. Para tipos de espaço de endereçamento X.400, o espaço de endereçamento que você inserir deve ser compatível com RFC 1685, como o=MySite;p=MyOrg;a=adatum;c=us. Para todos os outros valores de tipo de endereço, você pode inserir qualquer texto para o espaço de endereçamento.

  • AddressSpaceCost   O intervalo de entrada válido para o custo é de 1 a 100. Um custo mais baixo indica uma rota melhor. Se você omitir o custo do espaço de endereçamento, será usado um custo de 1. Se você inserir um espaço de endereçamento que contenha o caractere de ponto-e-vírgula, (;), será necessário especificar o custo do espaço de endereçamento.

Se você especificar o tipo de espaço de endereçamento ou o custo do espaço de endereçamento, deverá colocar o espaço de endereçamento entre aspas duplas ( " ). Por exemplo, as entradas de espaço de endereçamento a seguir são equivalentes:

  • "SMTP:contoso.com;1"

  • "contoso.com;1"

  • "SMTP:contoso.com"

  • contoso.com

Você pode especificar vários espaços de endereçamento, separando-os por vírgulas, como no exemplo a seguir: contoso.com,fabrikam.com. Se você especificar o tipo de espaço de endereçamento ou o custo do espaço de endereçamento, deverá colocar o espaço de endereçamento entre aspas duplas ( " ), como no exemplo a seguir: "contoso.com;2","fabrikam.com;3".

Name

Necessário

System.String

Esse parâmetro especifica um nome para o conector estrangeiro.

DomainController

Opcional

Microsoft.Exchange.Data.Fqdn

Para especificar o nome de domínio totalmente qualificado (FQDN) do controlador de domínio que grava essa alteração de configuração no serviço de diretório do Active Directory, inclua o parâmetro DomainController. O parâmetro DomainController não tem suporte em computadores que executam a função de servidor Transporte de Borda. A função de servidor Transporte de Borda lê e grava apenas na instância local do ADAM.

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.

IsScopedConnector

Opcional

System.Boolean

Esse parâmetro controla a disponibilidade do conector para outros servidores de Transporte de Hub. Quando o valor desse parâmetro for $False, o conector poderá ser usado por todos os servidores de Transporte de Hub da organização do Exchange. Quando o valor desse parâmetro for $True, o conector poderá ser usado apenas pelos servidores de Transporte de Hub do mesmo site do Active Directory. O valor padrão é $False.

SourceTransportServers

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

Esse parâmetro especifica os nomes dos servidores de Transporte de Hub que usam o conector estrangeiro. Você pode especificar vários servidores de Transporte de Hub separando os nomes dos servidores por vírgulas. Ter um único conector estrangeiro localizado em vários servidores de Transporte de Hub proporcionará tolerância a falhas e alta disponibilidade se um dos servidores de Transporte de Hub falhar. O valor padrão deste parâmetro é o nome do servidor de Transporte de Hub no qual esse conector estrangeiro foi instalado pela primeira vez.

TemplateInstance

Opcional

System.Management.Automation.PSObject

Quando um objeto existente é fornecido para este parâmetro, o cmdlet usa a configuração desse objeto para criar uma cópia do objeto.

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á visualizar 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 seguinte exemplo de código mostra um comando New-ForeignConnector que cria um novo conector estrangeiro com as seguintes propriedades:

  • Nome do conector: Conector estrangeiro Contoso

  • Espaço de endereçamento: "Contoso.com"

  • Tipo de espaço de endereçamento: SMTP

  • Custo do espaço de endereçamento: 5

  • Servidores de Transporte de Origem: Hub01 e Hub02

New-ForeignConnector -Name "Contoso Foreign Connector" -AddressSpaces "SMTP:*.contoso.com;5" -SourceTransportServers "Hub01,Hub02"