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 (Padrão)
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 Edge não tem acesso ao Active Directory. Todas as informações de configuração e destinatário são armazenadas na instância dos Serviços Lightweight Directory do Active Directory (AD LDS). O cmdlet New-EdgeSubscription cria o ficheiro de Subscrição do Edge para importar num servidor de Caixa de Correio no site do Active Directory onde pretende subscrever este servidor de Transporte do Edge.
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
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 ficheiro de Subscrição 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 ficheiro de Subscrição do Edge gerado no Exemplo 1 para o site do Active Directory Default-First-Site-Name; no entanto, o resultado final é realizado com 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
O parâmetro AccountExpiryDuration especifica a data de expiração da conta de replicação de bootstrap do EdgeSync (ESBRA) criada por este comando.
Para especificar um valor, introduza-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 predefinido é 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
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 |
-CreateInboundSendConnector
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
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ços enviar conector está definido como "--", os anfitriões inteligentes estão definidos como "--", o servidor de Transporte Edge é definido como o servidor de origem e o encaminhamento do Sistema de Nomes de Domínio (DNS) está desativado. 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
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
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
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 este parâmetro requer que leia o ficheiro para um objeto codificado por bytes com a seguinte sintaxe: ([System.IO.File]::ReadAllBytes('<Path>\<FileName>')). Pode utilizar este comando como o valor do parâmetro ou escrever a saída numa variável ($data = [System.IO.File]::ReadAllBytes('<Path>\<FileName>')) e utilizar a variável como o valor do parâmetro ($data).
Só pode utilizar este parâmetro quando estiver a executar o comando num 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
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
O comutador Forçar oculta mensagens de aviso ou confirmação. Não é preciso especificar um valor com essa opção.
Este comutador é útil nos seguintes cenários:
- Ignorar a confirmação ao criar um script do comando Subscrição do Edge.
- Recriar uma subscrição do servidor de Transporte do Edge 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
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 de Transporte edge 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
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.