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.
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.
Exemplos
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".
Parâmetros
-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 é: 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ço separando os espaços de endereço com vírgulas, por exemplo: contoso.com,fabrikam.com
. Se você especificar o tipo de espaço de endereço ou o custo do espaço de endereço, deverá incluir o espaço de endereço entre aspas ("), por exemplo: "contoso.com;2","fabrikam.com;3"
.
Para adicionar ou remover um ou mais valores de espaço de endereço sem afetar nenhuma entrada existente, use a seguinte sintaxe: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}
.
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Comment
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 |
Required: | False |
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, cmdlets Remove-*) têm uma pausa interna que força você a reconhecer o comando antes de prosseguir. Para estes cmdlets, você pode pular o pedido de confirmação usando esta sintaxe exata:
-Confirm:$false
. - A maioria dos outros cmdlets (por exemplo, cmdlets 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 |
Required: | False |
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.
O parâmetro DomainController não é compatível com os servidores de Transporte do Microsoft Edge. Um servidor de Transporte do Microsoft Edge usa a instância local dos Serviços AD LDS para ler e gravar dados.
Type: | Fqdn |
Position: | Named |
Default value: | None |
Required: | False |
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 Universal de Nomenclatura) 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 do RootDropDirectoryPath é a pasta de instalação do Exchange 2010. A pasta de instalação padrão do Exchange 2010 é C:\Arquivos do Programa\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 |
Required: | False |
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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Enabled
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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Force
A opção Forçar oculta mensagens de aviso ou confirmação. Não é preciso especificar um valor com essa opção.
Você pode usar essa opção para executar tarefas de modo programático onde a solicitação por entrada administrativa é inadequada.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
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\ConnectorName
Type: | ForeignConnectorIdParameter |
Position: | 1 |
Default value: | None |
Required: | True |
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 da caixa de correio na organização exchange. Quando o valor desse parâmetro é $true, o conector só pode ser usado por servidores da caixa de correio no mesmo site do Active Directory. O valor padrão é $false.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
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 |
Required: | False |
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 |
Required: | False |
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 |
Required: | False |
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, use a seguinte sintaxe: "Value1","Value2",..."ValueN"
.
Para adicionar ou remover um ou mais valores sem afetar nenhuma entrada existente, use a seguinte sintaxe: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}
.
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
Entradas
Input types
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.
Saídas
Output types
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.