Compartilhar via

Set-ForeignConnector

  • Artigo

 

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

Tópico modificado em: 2007-06-28

Use o cmdlet Set-ForeignConnector para modificar um conector externo existente em um computador executando o Microsoft Exchange Server 2007 e que possua a função de servidor Transporte de Hub instalada. Um Conector externo usa um Diretório de recebimento em um servidor de Transporte de Hub para enviar mensagens para um servidor de mensagens local que não usa o SMTP como seu 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

Set-ForeignConnector -Identity <ForeignConnectorIdParameter> [-AddressSpaces <MultiValuedProperty>] [-Comment <String>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-DropDirectory <String>] [-DropDirectoryQuota <Unlimited>] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-IsScopedConnector <$true | $false>] [-MaxMessageSize <Unlimited>] [-Name <String>] [-RelayDsnRequired <$true | $false>] [-SourceTransportServers <MultiValuedProperty>] [-WhatIf [<SwitchParameter>]]

Set-ForeignConnector [-AddressSpaces <MultiValuedProperty>] [-Comment <String>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-DropDirectory <String>] [-DropDirectoryQuota <Unlimited>] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-Instance <ForeignConnector>] [-IsScopedConnector <$true | $false>] [-MaxMessageSize <Unlimited>] [-Name <String>] [-RelayDsnRequired <$true | $false>] [-SourceTransportServers <MultiValuedProperty>] [-WhatIf [<SwitchParameter>]]

Descrição detalhada

O cmdlet Set-ForeignConnector modifica um conector externo existente. As alterações de propriedade especificadas ao usar o cmdlet Set-ForeignConnector substituem os valores de propriedade existentes.

Para executar o cmdlet Set-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(s) Tipo Descrição

Identity

Necessário(s)

Microsoft.Exchange.Configuration.Tasks.ForeignConnectorIdParameter

Este parâmetro especifica o conector externo a ser modificado. O parâmetro Identity pode assumir qualquer um dos seguintes valores para o objeto do conector externo:

  • GUID

  • Nome do conector

  • ServerName\ConnectorName

AddressSpaces

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

Esse parâmetro especifica os nomes de domínio aos quais o conector externo 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 deverá 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 não SMTP 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".

Comment

Opcional

System.String

Este parâmetro especifica um comentário opcional para o conector externo. Coloque o parâmetro Comment entre aspas duplas, conforme o exemplo a seguir: "esta é uma nota administrativa".

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 grava essa alteração de configuração no serviço de diretório do Active Directory, inclua o parâmetro DomainController.

DropDirectory

Opcional

System.String

Este parâmetro especifica o nome do Diretório de recebimento usado pelo conector externo. Todas as mensagens de saída enviadas a espaços de endereçamento definidos pelo conector externo são colocadas no Diretório de recebimento especificado. O local do diretório de Recebimento para cada Conector Externo é controlado pelos dois itens a seguir:

  • O parâmetro RootDropDirectoryPath no cmdlet Set-TransportServer   Essa opção é usada para todos os conectores externos que existem no servidor de Transporte de Hub. O valor do parâmetro RootDropDirectoryPath pode ser um caminho local ou um caminho UNC (Convenção de Nomenclatura Universal) para um servidor remoto.

  • O parâmetro DropDirectory no cmdlet Set-ForeignConnector   Esse valor é definido para cada Conector Externo que existe no servidor de Transporte de Hub.

Por padrão, o valor do parâmetro RootDropDirectoryPath está em branco. Isso indica que o valor de RootDropDirectoryPath é a pasta de instalação do Exchange 2007. A pasta de instalação padrão do Exchange 2007 é C:\Arquivos de Programas\Microsoft\Exchange Server\. Por padrão, o valor do parâmetro DropDirectory é o nome do conector externo.

Se o valor do parâmetro DropDirectory não contiver um caminho absoluto, o local do diretório de recebimento será definido pela combinação dos parâmetros DropDirectory e RootDropDirectoryPath. Se o valor do parâmetro DropDirectory contiver informações de caminho absoluto, o valor do RootDropDirectoryPath não deverá ser especificado. O local do Diretório de recebimento é definido apenas pelo valor do parâmetro DropDirectory.

O Diretório de recebimento não é criado para você. Portanto, você precisará criar manualmente cada pasta Diretório de recebimento.

O Diretório de recebimento deve ter as seguintes permissões a ele atribuídas:

  • Serviço de Rede: Controle Total

  • Sistema: Controle Total

  • Administradores: Controle Total

DropDirectoryQuota

Opcional

Microsoft.Exchange.Data.Unlimited

Este parâmetro especifica o tamanho máximo de todos os arquivos de mensagens no Diretório de recebimento. Quando o valor especificado é atingido, nenhum arquivo de mensagem novo pode ser copiado para o Diretório de recebimento até que as mensagens existentes sejam entregues e excluídas. Quando você inserir um valor para o parâmetro DropDirectoryQuota, qualifique o valor com uma das seguintes unidades:

  • B (bytes)

  • KB (quilobytes)

  • MB (megabytes)

  • GB (gigabytes)

  • TB (terabytes)

Os valores não qualificados são considerados bytes. O intervalo de entrada válido para esse parâmetro é de 1 a 2147483647 bytes. Se você inserir um valor de unlimited, não será imposto um limite de tamanho de mensagem ao Diretório de recebimento. O valor padrão é unlimited.

Enabled

Opcional

System.Boolean

Este parâmetro habilita ou desabilita o conector externo. Os valores de entrada válidos são $True ou $False. O valor padrão é $True.

Force

Optional

System.Management.Automation.SwitchParameter

Esse parâmetro suprime as mensagens de aviso ou de confirmação exibidas durante alterações específicas na configuração.

Instance

Opcional

Microsoft.Exchange.Data.Directory.SystemConfiguration.ForeignConnector

O parâmetro Instance permite que você passe um objeto inteiro para o comando a ser processado. Ele é usado principalmente quando um objeto inteiro deve ser passado para o comando.

IsScopedConnector

Optional

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.

MaxMessageSize

Opcional

Microsoft.Exchange.Data.Unlimited

Este parâmetro especifica o tamanho máximo de uma mensagem que pode passar por esse conector externo. Quando você inserir um valor para o parâmetro MaxMessageSize, qualifique o valor com uma das seguintes unidades:

  • B (bytes)

  • KB (quilobytes)

  • MB (megabytes)

  • GB (gigabytes)

  • TB (terabytes)

Os valores não qualificados são considerados quilobytes. Se você inserir um valor de unlimited, não será imposto um limite de tamanho de mensagem a esse conector externo. O valor padrão é unlimited. O intervalo de entrada válido para esse parâmetro é de 0 a 2147483647 quilobytes. Se definir o valor do parâmetro MaxMessageSize como 0, desabilitará permanentemente o conector externo. Entretanto, se definir o valor do parâmetro MaxMessageSize como 0 quando o valor do atributo Enabled for $True, você gerará erros de log de eventos. O método preferido para desabilitar o conector externo é usar o parâmetro Enabled.

Name

Opcional

System.String

Este parâmetro especifica um nome descritivo para o conector externo.

RelayDsnRequired

Opcional

System.Boolean

Este parâmetro especifica se uma DNS (notificação de status de entrega) de Retransmissão é necessária para o conector externo quando as mensagens forem gravadas no Diretório de recebimento. Os valores válidos desse parâmetro são $True ou $False. 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 externo. Você pode especificar vários servidores de Transporte de Hub separando os nomes dos servidores por vírgulas. Ter um único conector externo 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 externo foi instalado pela primeira vez.

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 mostra dois exemplos que usam o cmdlet Set-ForeignConnector.

O primeiro exemplo mostra um comando Set-ForeignConnector que modifica um Conector externo existente, chamado "Conector Externo Contoso". O comando define o parâmetro MaxMessageSize como 10 MB.

O segundo exemplo mostra um comando Set-ForeignConnector que modifica os espaços de endereçamento que são gerenciados por um conector externo existente chamado "Conector Externo Contoso". Os detalhes dos espaços de endereçamento são os seguintes:

  • Primeiro espaço de endereçamento:

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

    • Espaço de endereçamento: "*.contoso.com"

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

  • Segundo espaço de endereçamento:

    • Tipo de espaço de endereçamento: Lotus Notes

    • Espaço de endereçamento: "*@domino"

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

Set-ForeignConnector "Contoso Foreign Connector" -MaxMessageSize 10MB
Set-ForeignConnector "Contoso Foreign Connector" -AddressSpaces ".contoso.com","Lotus Notes:*@domino;55"