New-DeliveryAgentConnector
Este cmdlet está disponível somente no Exchange local.
O cmdlet New-DeliveryAgentConnector cria um novo conector de agente de entrega em sua organização.
Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.
Syntax
New-DeliveryAgentConnector
[-Name] <String>
-AddressSpaces <MultiValuedProperty>
-DeliveryProtocol <String>
[-Comment <String>]
[-Confirm]
[-DomainController <Fqdn>]
[-Enabled <Boolean>]
[-IsScopedConnector <Boolean>]
[-MaxConcurrentConnections <Int32>]
[-MaxMessageSize <Unlimited>]
[-MaxMessagesPerConnection <Int32>]
[-SourceTransportServers <MultiValuedProperty>]
[-WhatIf]
[<CommonParameters>]
Description
Os conectores do agente de entrega são usados para rotear mensagens endereçadas a sistemas externos que não utilizam o protocolo SMTP. Quando uma mensagem é roteada para um conector de agente de entrega, o agente de entrega associado executa a conversão do conteúdo e a entrega da mensagem. Os conectores do agente de entrega permitem enfileirar o gerenciamento de conectores externos, o que elimina a necessidade de armazenar mensagens no sistema de arquivos nos diretórios de Recebimento e de Retirada. Para obter mais informações, consulte Agentes de entrega e conectores do Agente de Entrega.
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
New-DeliveryAgentConnector -Name "Contoso X.400 Connector" -AddressSpaces "X400:c=US;a=Fabrikam;p=Contoso;1" -DeliveryProtocol "X.400" -SourceTransportServers Hub01,Hub02,Hub05
Este exemplo cria um conector de agente de entrega chamado Conector Contoso X.400 com a seguinte configuração:
O conector de agente de entrega está hospedado nos seguintes servidores:
- Hub01
- Hub02
- Hub05
O conector de agente de entrega é designado para lidar com conexões X.400 para uma empresa chamada Contoso que usa a portadora Fabrikam.
O espaço de endereçamento para o conector é c=US;a=Fabrikam;p=Contoso.
Parâmetros
-AddressSpaces
O parâmetro AddressSpaces especifica os nomes de domínio pelos quais o conector do agente de entrega é responsável. A sintaxe completa para inserir um espaço de endereço é: AddressSpaceType:AddressSpace;AddressSpaceCost
. Inclua cada espaço de endereço entre aspas (").
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | True |
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 |
-DeliveryProtocol
O parâmetro DeliveryProtocol especifica o protocolo de comunicação que determina quais agentes de entrega são responsáveis por atender o conector.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
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 |
-Enabled
O parâmetro Enabled especifica se o conector de agente de entrega está habilitado.
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 |
-IsScopedConnector
O parâmetro IsScopedConnector especifica a disponibilidade do conector para outros servidores de Caixa de Correio. Se o valor desse parâmetro for $false, o conector poderá ser usado por todos os servidores de Caixa de Correio da sua organização. Se o valor desse parâmetro for $true, o conector só poderá 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 |
-MaxConcurrentConnections
O parâmetro MaxConcurrentConnections especifica o número máximo de conexões simultâneas que este conector aceita de um endereço IP específico. O valor padrão é 5.
Type: | Int32 |
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 é permitido passar por esse conector. 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)
Valores não qualificados são tratados como bytes. O intervalo de entrada válido para qualquer parâmetro é de 65536 a 2147483647 bytes. 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 |
-MaxMessagesPerConnection
O parâmetro MaxMessagesPerConnection especifica o número máximo de mensagens que este conector aceita por conexão. O conector encerra a conexão após este limite ser atingido, o servidor remetente precisa iniciar uma nova conexão para enviar mais mensagens. O valor padrão é 20.
Type: | Int32 |
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 o nome deste conector de agente de entrega. O valor para o parâmetro Name não pode exceder 64 caracteres.
Type: | String |
Position: | 1 |
Default value: | None |
Required: | True |
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 a lista de servidores de Caixa de Correio que usam este conector. Você pode especificar mais de um servidor, separando seus nomes com vírgulas.
Por padrão, apenas o servidor local em que o comando é executado é adicionado a este parâmetro.
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.