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.

Sintaxe

Default (Default)

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 de Borda 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 para importar em um servidor de Caixa de Correio no site do Active Directory em que você deseja assinar este servidor de Transporte de Borda.

Para executar esse cmdlet, você precisa ter permissões. Embora este artigo 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

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

O parâmetro AccountExpiryDuration especifica em quanto tempo a conta de replicação de bootstrap do EdgeSync (ESBRA) criada por esse comando expira.

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.

Propriedades do parâmetro

Tipo:TimeSpan
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, Exchange Server SE

A opção Confirm especifica se a solicitação de confirmação deve ser mostrada ou ocultada. A forma como essa opção afeta o cmdlet depende se o cmdlet requer 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 reconhecer 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

-CreateInboundSendConnector

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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 de envio é definido como "--", os hosts inteligentes são definidos como "--", o servidor de Transporte de Borda é definido como servidor de origem e o roteamento do Sistema de Nomes de Domínio (DNS) está desabilitado. Esse parâmetro é usado somente ao executar o comando no servidor de Transporte de Hub.

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

-CreateInternetSendConnector

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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.

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

-DomainController

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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

-FileData

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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 byte usando a seguinte sintaxe: ([System.IO.File]::ReadAllBytes('<Path>\<FileName>')). Você pode usar esse comando como o valor do parâmetro ou pode 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 de Caixa de Correio.

Propriedades do parâmetro

Tipo:

Byte[]

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

-FileName

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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.

Propriedades do parâmetro

Tipo:LongPath
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, Exchange Server SE

A opção Forçar oculta mensagens de aviso ou confirmação. Não é preciso especificar um valor com essa opção.

Esta opção é útil nos seguintes cenários:

  • Ignorando a confirmação quando você faz o script do comando Edge Subscription.
  • Recriar uma assinatura de servidor de Transporte de Borda e substituir as informações de configuração existentes.

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

-Site

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

O parâmetro Site especifica o nome do site do Active Directory que contém os servidores de Caixa de Correio aos quais os servidores de Transporte de Borda estão associados. Esse parâmetro é usado somente ao executar o comando em um servidor de caixa de correio.

Propriedades do parâmetro

Tipo:AdSiteIdParameter
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, Exchange Server SE

A opção WhatIf mostra o que o comando faz sem fazer nenhuma alteração. 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 dá suporte aos 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.