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.
Sintaxe
Default (Padrão)
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. Os servidores de gateway de fax não Microsoft são exemplos de servidores de 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 artigo liste todos os parâmetros do cmdlet, poderá não ter acesso a alguns parâmetros se não estiverem incluídos nas permissões que lhe foram atribuídas. 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
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
O parâmetro AddressSpaces especifica os nomes de domínio aos quais o Conector estrangeiro envia mensagens. A sintaxe completa para introduzir cada espaço de endereços é: AddressSpaceType:AddressSpace;AddressSpaceCost.
- AddressSpaceType: o tipo de espaço de endereço pode ser SMTP, X400 ou qualquer outra cadeia 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
Pode especificar vários espaços de endereços separando os espaços de endereços com vírgulas, por exemplo: contoso.com,fabrikam.com. Se especificar o tipo de espaço de endereço ou o custo do espaço de endereços, tem de colocar 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ços sem afetar as entradas existentes, utilize a seguinte sintaxe: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.
Propriedades do parâmetro
| Tipo: | MultiValuedProperty |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Comment
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
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”.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Confirm
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
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 estes cmdlets, você pode pular o pedido 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.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | cf |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-DomainController
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
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.
Propriedades do parâmetro
| Tipo: | Fqdn |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-DropDirectory
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
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 (Universal Naming Convention) 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. Isto indica que o valor de RootDropDirectoryPath é a pasta de instalação do Exchange 2010. A pasta de instalação predefinida do Exchange 2010 é C:\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ê. 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
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-DropDirectoryQuota
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
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)
Os valores não qualificados são normalmente tratados como bytes, mas os valores pequenos podem ser arredondados até ao quilobyte mais próximo.
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.
Propriedades do parâmetro
| Tipo: | Unlimited |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Enabled
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
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.
Propriedades do parâmetro
| Tipo: | Boolean |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Force
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
O comutador 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.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Identity
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
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
Propriedades do parâmetro
| Tipo: | ForeignConnectorIdParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 1 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-IsScopedConnector
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
O parâmetro IsScopedConnector especifica a disponibilidade do conector para outros servidores de Caixa de Correio. Quando o valor deste parâmetro é $false, o conector pode ser utilizado por todos os servidores da Caixa de Correio na organização do Exchange. Quando o valor deste parâmetro é $true, o conector só pode ser utilizado pelos servidores da Caixa de Correio no mesmo site do Active Directory. O valor predefinido é $false.
Propriedades do parâmetro
| Tipo: | Boolean |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-MaxMessageSize
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
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)
Os valores não qualificados são normalmente tratados como bytes, mas os valores pequenos podem ser arredondados até ao quilobyte mais próximo.
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.
Propriedades do parâmetro
| Tipo: | Unlimited |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Name
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
O parâmetro Name especifica um nome descritivo para o conector externo.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-RelayDsnRequired
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
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 predefinido é $false.
Propriedades do parâmetro
| Tipo: | Boolean |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-SourceTransportServers
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
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 as 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"...}.
Propriedades do parâmetro
| Tipo: | MultiValuedProperty |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-WhatIf
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
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.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | wi |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.
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.