New-EdgeSubscription
Este cmdlet está disponível somente no Exchange local.
Use o cmdlet New-EdgeSubscription para exportar um arquivo de Assinatura de Borda de um servidor de Transporte de Borda e para importar o arquivo de Assinatura de Borda para 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
New-EdgeSubscription
[-AccountExpiryDuration <TimeSpan>]
[-Confirm]
[-CreateInboundSendConnector <Boolean>]
[-CreateInternetSendConnector <Boolean>]
[-DomainController <Fqdn>]
[-FileData <Byte[]>]
[-FileName <LongPath>]
[-Force]
[-Site <AdSiteIdParameter>]
[-WhatIf]
[<CommonParameters>]
Description
O servidor de Transporte do Edge não tem acesso ao Active Directory. Todas as informações de configuração e destinatário são armazenadas na instância do AD LDS (Active Directory Lightweight Directory Services). O cmdlet New-EdgeSubscription cria o arquivo de Assinatura do Edge que será importado em um servidor de caixa de correio no site do Active Directory para o qual você deseja assinar este servidor do Edge Transport.
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-EdgeSubscription -FileName "C:\Data\EdgeSubscription.xml"
Este exemplo cria o arquivo de Inscrição de Borda. Ele deve ser executado no servidor de Transporte de Borda.
Exemplo 2
$Temp = [System.IO.File]::ReadAllBytes('C:\Data\EdgeSubscription.xml')
New-EdgeSubscription -FileData $Temp -Site "Default-First-Site-Name"
Este exemplo importa o arquivo de Assinatura do Edge gerado no Exemplo 1 para o site do Active Directory Default-First-Site-Name. A importação do arquivo de Inscrição de Borda conclui o processo de Inscrição de Borda. Você deve executar este comando no servidor de caixa de correio.
O primeiro comando lê os dados do arquivo de Inscrição de Borda e os armazena em uma variável temporária como um objeto de dados codificado por bytes. O segundo comando conclui o processo de Inscrição de Borda.
Exemplo 3
New-EdgeSubscription -FileData ([System.IO.File]::ReadAllBytes('C:\Data\EdgeSubscription.xml')) -Site "Default-First-Site-Name"
Este exemplo também importa o arquivo de Assinatura do Edge gerado no Exemplo 1 para o site do Active Directory Default-First-Site-Name; no entanto, o resultado final é realizado usando um comando. Você deve executar este comando no servidor de caixa de correio.
Parâmetros
-AccountExpiryDuration
O parâmetro AccountExpiryDuration especifica em quanto tempo a conta de replicação de inicialização do EdgeSync (ESBRA) criada por esse comando expirará.
Para especificar um valor, insira-o como um intervalo de tempo: dd.hh:mm:ss em que dd = dias, hh = horas, mm = minutos e ss = segundos.
O valor desse parâmetro deve ser de pelo menos 00:02:00 ou 2 minutos. O valor padrão é 24:00:00 ou 24 horas.
Type: | TimeSpan |
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 |
-CreateInboundSendConnector
O parâmetro CreateInboundSendConnector especifica se é necessário criar o conector de envio para conectar o servidor de Transporte de Borda e os servidores Transporte de Hub. O valor padrão é $true. O espaço de endereço do conector Enviar é definido como "--", os hosts inteligentes são definidos como "--", o servidor de Transporte de Borda é definido como o servidor de origem e o roteamento DNS (Sistema de Nomes de Domínio) está desabilitado. Esse parâmetro é usado somente ao executar o comando no servidor de Transporte de Hub.
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 |
-CreateInternetSendConnector
O parâmetro CreateInternetSendConnector especifica se é necessário criar o conector de envio para se conectar à Internet. O valor padrão é $true. O espaço de endereçamento do Conector de envio é definido para todos os domínios (*), o servidor de Transporte de Borda é definido como o servidor de origem, e o roteamento DNS é habilitado. Esse parâmetro é usado somente ao executar o comando no servidor de Transporte de Hub.
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 |
-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 |
-FileData
O parâmetro FileData especifica o objeto de dados codificado por byte que contém as informações do arquivo de inscrição de borda.
Um valor válido para esse parâmetro exige que você leia o arquivo em um objeto codificado por bytes usando a seguinte sintaxe: ([System.IO.File]::ReadAllBytes('<Path>\<FileName>'))
. Você pode usar esse comando como o valor do parâmetro ou gravar a saída em uma variável ($data = [System.IO.File]::ReadAllBytes('<Path>\<FileName>')
) e usar a variável como o valor do parâmetro ($data
).
Você só pode usar esse parâmetro quando estiver executando o comando em um servidor da Caixa de Correio.
Type: | Byte[] |
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 |
-FileName
O parâmetro FileName especifica o caminho completo do arquivo de inscrição de borda.
Só é possível usar esse parâmetro quando você está executando o comando em um servidor de Transporte de Borda.
Type: | LongPath |
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.
Essa opção é útil nos seguintes cenários:
- Ignorando a confirmação quando você roteia o comando Assinatura do Edge.
- Recriando uma assinatura do servidor do Edge Transport e substituindo as informações de configuração existentes.
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 |
-Site
O parâmetro Site especifica o nome do site do Active Directory que contém os servidores da caixa de correio com os quais os servidores do Edge Transport estão associados. Esse parâmetro é usado somente ao executar o comando em um servidor de caixa de correio.
Type: | AdSiteIdParameter |
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.