Set-ForeignConnector

Este cmdlet está disponível somente no Exchange local.

Use o cmdlet Set-ForeignConnector para modificar um conector externo no serviço de Transporte de um servidor de Caixa de Correio.

Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax (https://docs.microsoft.com/powershell/exchange/exchange-cmdlet-syntax).

Syntax

Set-ForeignConnector
   [-Identity] <ForeignConnectorIdParameter>
   [-AddressSpaces <MultiValuedProperty>]
   [-Comment <String>]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-DropDirectory <String>]
   [-DropDirectoryQuota <Unlimited>]
   [-Enabled <Boolean>]
   [-Force]
   [-IsScopedConnector <Boolean>]
   [-MaxMessageSize <Unlimited>]
   [-Name <String>]
   [-RelayDsnRequired <Boolean>]
   [-SourceTransportServers <MultiValuedProperty>]
   [-WhatIf]
   [<CommonParameters>]

Description

Um Conector estrangeiro pode usar o diretório de recebimento em um servidor de Caixa de Correio para enviar mensagens para um servidor de mensagens local que não use SMTP como o 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 estrangeiro podem ser SMTP ou não-SMTP.

Para executar esse cmdlet, você precisa ter permissões. Embora este tópico liste todos os parâmetros do cmdlet, talvez você não tenha acesso a alguns parâmetros se eles não estiverem incluídos nas permissões atribuídas a você. Para localizar as permissões necessárias para executar qualquer cmdlet ou parâmetro em sua organização, confira Find the permissions required to run any Exchange cmdlet.

Examples

Exemplo 1

Set-ForeignConnector "Fax Connector" -MaxMessageSize 10MB

Este exemplo configura um limite de tamanho de mensagem de 10 MB no conector externo chamado "Fax Connector".

Parameters

-AddressSpaces

O parâmetro AddressSpaces especifica os nomes de domínio aos quais o Conector estrangeiro envia mensagens. A sintaxe completa para inserir cada espaço de endereço é 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 válido de entrada 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ê digitar um espaço de endereçamento que não seja SMTP que contenha um 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 de espaço de endereçamento, deverá colocar o espaço de endereçamento entre aspas ("). 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, por exemplo: contoso.com,fabrikam.com. Se você especificar o tipo de espaço de endereçamento ou o custo de espaço de endereçamento, deverá colocar o espaço de endereçamento entre aspas ("): "contoso.com;2","fabrikam.com;3".

Para adicionar ou remover um ou mais valores de espaço de endereço sem afetar as entradas existentes, use a seguinte sintaxe: @ {Add = " <value1> ", " <value2> "...; Remove = " <value1> ", " <value2> "...}.

Type:MultiValuedProperty
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-Comentário

O parâmetro Comment especifica um comentário opcional. Se você especificar um valor que contenha espaços, coloque-o entre aspas ("), por exemplo: “Está é uma observação de administrador”.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-Confirm

A opção Confirm especifica se a solicitação de confirmação deve ser mostrada ou ocultada. Como essa opção afeta o cmdlet dependerá do fato de o cmdlet exigir ou não confirmação antes de continuar.

  • Cmdlets destrutivos (por exemplo, Remover-* cmdlets) têm uma pausa interna que força você a confirmar o comando antes de continuar. Para esses cmdlets, você pode ignorar a solicitação de confirmação usando esta sintaxe exata: -Confirm:$false.

  • A maioria dos outros cmdlets (por exemplo, New-* e Set-*) não tem uma pausa interna. Para esses cmdlets, especificar a opção Confirm sem um valor introduz uma pausa que força você a confirmar o comando antes de continuar.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-DomainController

O parâmetro DomainController especifica o controlador de domínio que é usado por esse cmdlet para ler dados ou gravar dados no Active Directory. Você identifica o controlador de domínio por seu FQDN (nome de domínio totalmente qualificado). Por exemplo, dc01.contoso.com.

Não há suporte para o parâmetro DomainController na função de servidor Transporte de Borda. Um servidor de transporte de borda usa a instância local do Active Directory Lightweight Directory Services (AD LDS) para ler e gravar dados.

Type:Fqdn
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-DropDirectory

O parâmetro DropDirectory 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-TransportService: Essa opção é usada para todos os conectores externos que existem no servidor de Caixa de Correio. 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 todos os conectores externos que existem no servidor.

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 2010. A pasta de instalação padrão do Exchange 2010 é C: \ arquivos de programa \ do 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ê. Dessa forma, você precisa 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

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-DropDirectoryQuota

O parâmetro DropDirectoryQuota 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.

Um valor válido é um número até 1,999999999 terabytes (2199023254528 bytes) ou o valor unlimited. O valor padrão é 6 gigabytes (6442450944 bytes).

  • B (bytes)

  • KB (quilobytes)

  • MB (megabytes)

  • GB (gigabytes)

  • TB (terabytes)

TB (terabytes)

O intervalo válido de entrada para qualquer 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.

Type:Unlimited
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-Força

A opção Force especifica se é preciso suprimir mensagens de aviso ou confirmação. Você pode usar essa opção para executar tarefas de modo programático onde a solicitação por entrada administrativa é inadequada. Não é preciso especificar um valor com essa opção.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-Habilitado

O parâmetro Enabled especifica se o conector externo deve ser habilitado. Os valores válidos são $verdadeiro ou $falso. O valor padrão é $true.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-Identity

O parâmetro Identity 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 \ Connector

Type:ForeignConnectorIdParameter
Position:1
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-IsScopedConnector

O parâmetro IsScopedConnector especifica a disponibilidade do conector para outros servidores de Caixa de Correio. Quando o valor desse parâmetro é $false, o conector pode ser usado por todos os servidores de caixa de correio na organização do Exchange. Quando o valor desse parâmetro é $true, o conector pode ser usado apenas por servidores de caixa de correio no mesmo site do Active Directory. O valor padrão é $false.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-MaxMessageSize

O parâmetro MaxMessageSize especifica o tamanho máximo de uma mensagem que pode passar por esse conector externo.

Um valor válido é um número até 1,999999999 terabytes (2199023254528 bytes) ou o valor unlimited. O valor padrão é 6 gigabytes (6442450944 bytes).

  • B (bytes)

  • KB (quilobytes)

  • MB (megabytes)

  • GB (gigabytes)

  • TB (terabytes)

TB (terabytes)

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álida para qualquer parâmetro é de 0 a 2147483647 quilobytes. Se você definir o valor do parâmetro MaxMessageSize como 0, desabilitará permanentemente o conector externo. No entanto, se você definir o valor do parâmetro MaxMessageSize como 0 quando o valor do atributo Enabled for $true, haverá erros no log de eventos. O método preferido para desabilitar o conector externo é usar o parâmetro Enabled.

Type:Unlimited
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-Name

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

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-RelayDsnRequired

O parâmetro RelayDsnRequired 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.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-SourceTransportServers

O parâmetro SourceTransportServers especifica os nomes dos servidores de Caixa de Correio que usam o conector Estrangeiro. Ter um único conector externo localizado em vários servidores de caixa de correio com o serviço de Transporte permitirá tolerância a failover e alta disponibilidade, se um dos servidores falhar. O valor padrão deste parâmetro é o nome do servidor de caixa de correio no qual esse conector externo foi instalado pela primeira vez.

Para inserir vários valores e substituir quaisquer entradas existentes, use a seguinte sintaxe: <value1> , <value2> ,... <valueN> . Se os valores contiverem espaços ou exigirem aspas, você precisará usar a seguinte sintaxe: " <value1> ", " <value2> ",... " <valueN> ".

Para adicionar ou remover um ou mais valores sem afetar as entradas existentes, use a seguinte sintaxe: @ {Add = " <value1> ", " <value2> "...; Remove = " <value1> ", " <value2> "...}.

Type:MultiValuedProperty
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-WhatIf

A opção WhatIf simula as ações do comando. Você pode usar essa opção para exibir as alterações que ocorreriam sem realmente aplicar essas alterações. Não é preciso especificar um valor com essa opção.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

Inputs

Para ver os tipos de entrada que este cmdlet aceita, confira Tipos de entrada e saída de cmdlet. Se o campo Tipo de Entrada de um cmdlet estiver em branco, isso significa que o cmdlet não aceita dados de entrada.

Outputs

Para ver os tipos de retorno, também conhecidos como tipos de saída, que este cmdlet aceita, consulte Tipos de entrada e saída de cmdlet. Se o campo Tipo de Saída estiver em branco, o cmdlet não retorna dados.