Compartilhar via

Set-ForeignConnector (RTM)

  • Artigo

 

Aplica-se a: Exchange Server 2007

Tópico modificado em: 2007-06-11

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>] [-DomainController <Fqdn>] [-DropDirectory <String>] [-DropDirectoryQuota <Unlimited>] [-Enabled <$true | $false>] [-MaxMessageSize <Unlimited>] [-Name <String>] [-RelayDsnRequired <$true | $false>] [-SourceTransportServers <MultiValuedProperty>]

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

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 Tipo Descrição

Identity

Necessário

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. Você pode especificar vários espaços de endereçamento, separando-os por vírgulas. A sintaxe completa para inserir cada espaço de endereçamento é a seguinte:

<ConnectorScope>:<AddressSpaceType>:<AddressSpace>;<AddressSpaceCost>

  • ConnectorScope   Se você especificar um valor de Local, o conector poderá ser usado apenas por outros servidores de Transporte de Hub existentes no mesmo site do Active Directory que o servidor de Transporte de Hub de origem no qual você está executando o cmdlet New-SendConnector. Se você omitir o qualificador ConnectorScope, o conector poderá ser usado por todos os servidores de Transporte de Hub existentes em toda a organização do Exchange 2007.

  • AddressSpaceType   Para espaços de endereçamento SMTP, esse valor deve ser SMTP. Para espaços de endereçamento não-SMTP, esse valor deve ser qualquer cadeia de caracteres de texto descritiva, como "Lotus Notes".

  • AddressSpace   Para espaços de endereçamento SMTP, o caractere curinga (*) do DNS (sistema de nomes de domínio), conforme definido no RFC 1035, pode ser usado, como "*", "*.com." ou *.contoso.com", por exemplo. Para espaços de endereçamento não-SMTP, os caracteres curinga (*) e outros caracteres podem ser usados, como "*contoso.com" ou "@contoso", por exemplo.

  • AddressSpaceCost  O intervalo de entrada válido para o custo é de 1 a 100. Um custo mais baixo indica uma rota melhor. Este parâmetro é opcional. Se você omitir o qualificador AddressSpaceCost ao inserir um espaço de endereçamento usando a sintaxe completa, será usado um custo 1.

Você deve usar a sintaxe completa para o parâmetro AddressSpaces somente para as condições a seguir:

  • Conectores do escopo que tenham o qualificador Local

  • Espaços de endereçamento não SMTP

  • Espaços de endereçamento SMTP com um custo diferente de 1

Se você inserir um nome de domínio ou uma lista separada por vírgulas de nomes de domínio para o valor do parâmetro AddressSpaces, será adotado o tipo de espaço de endereçamento do SMTP e um custo igual a 1 para cada nome de domínio.

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".

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.

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 do parâmetro 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)

Valores não qualificados são tratados como bytes. O intervalo de entrada válido para esse parâmetro é de 1 a 2147483647bytes. 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.

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.

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.

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"