Add-MailboxDatabaseCopy

Este cmdlet está disponível somente no Exchange local.

Use o cmdlet Add-MailboxDatabaseCopy para criar uma cópia passiva de um banco de dados de caixa de correio existente.

Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.

Syntax

Add-MailboxDatabaseCopy
   [-Identity] <DatabaseIdParameter>
   [-MailboxServer] <MailboxServerIdParameter>
   [-ActivationPreference <UInt32>]
   [-ConfigurationOnly]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-ReplayLagMaxDelay <EnhancedTimeSpan>]
   [-ReplayLagTime <EnhancedTimeSpan>]
   [-SeedingPostponed]
   [-TruncationLagTime <EnhancedTimeSpan>]
   [-WhatIf]
   [<CommonParameters>]

Description

Para usar o cmdlet Add-MailboxDatabaseCopy e adicionar uma cópia do banco de dados de caixa de correio, os seguintes critérios devem ser atendidos:

  • O servidor de caixa de correio especificado deve estar no mesmo grupo de disponibilidade de banco de dados (DAG), e esse DAG deve ter quórum e estar íntegro.
  • O servidor Caixa de Correio especificado não deve hospedar uma cópia do banco de dados da caixa de correio especificada.
  • O caminho do banco de dados usado pelo banco de dados especificado também deve estar disponível no servidor Caixa do Correio especificado, porque todas as cópias de um banco de dados devem usar o mesmo caminho.
  • Se você estiver adicionando uma segunda cópia de um banco de dados (por exemplo, adicionando a primeira cópia passiva do banco de dados), o log circular não pode estar habilitado para o banco de dados de caixa de correio especificado. Se o log circular estiver habilitado, você deverá desabilitá-lo. Depois de ter adicionado a cópia do banco de dados de caixa de correio, o log circular poderá ser habilitado. Após se habilitar o log circular para um banco de dados de caixa de correio replicado, o log circular de replicação contínua (CRCL) é usado no lugar do log circular JET. Se você estiver adicionando a terceira cópia (ou posterior) de um banco de dados, poderá deixar o CRCL habilitado.

Após a execução do cmdlet Add-MailboxDatabaseCopy, a nova cópia permanecerá em um estado Suspenso, se o parâmetro SeedingPostponed for especificado. Quando o status da cópia do banco de dados é definido como Suspenso, o SuspendMessage é definido como "A replicação está suspensa para cópia de banco de dados '{0}' porque o banco de dados precisa ser semeado".

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

Add-MailboxDatabaseCopy -Identity DB1 -MailboxServer MBX3 -ReplayLagTime 00:10:00 -TruncationLagTime 00:15:00 -ActivationPreference 2

Este exemplo adiciona uma cópia do banco de dados de caixa de correio DB1 ao servidor de Caixa de Correio chamado MBX3. O tempo de retardo repetido e o tempo de retardo do truncamento são configurados com valores de 10 e de 15 minutos, respectivamente. A preferência de ativação está configurada com um valor igual a 2.

Exemplo 2

Add-MailboxDatabaseCopy -Identity DB2 -MailboxServer MBX1 -ActivationPreference 3

Este exemplo adiciona uma cópia do banco de dados de caixa de correio DB2 ao servidor de Caixa de Correio chamado MBX1. O tempo de retardo repetido e o tempo de retardo do truncamento ficam com valores padrão iguais a zero, e a preferência de ativação é configurada com um valor igual a 3.

Exemplo 3

Add-MailboxDatabaseCopy -Identity DB3 -MailboxServer MBX4 -ActivationPreference 5 -SeedingPostponed

Este exemplo adiciona uma cópia do banco de dados de caixa de correio DB3 ao servidor de Caixa de Correio chamado MBX4. O tempo de atraso de reprodução e o tempo de atraso de truncamento são deixados nos valores padrão de zero e a preferência de ativação é configurada com um valor de 5. Além disso, a propagação é adiada para essa cópia, para que ela possa ser propagada usando-se um servidor de origem, e não a cópia de banco de dados ativa atual, geograficamente distante de MBX4.

Parâmetros

-ActivationPreference

O parâmetro ActivationPreference é usado como parte do processo de seleção de melhor cópia do Active Manager e para redistribuir os bancos de dados da caixa de correio ativa em todo o DAG ao usar o script RedistributeActiveDatabases.ps1. O valor de preferência de ativação é um número igual a ou maior que 1, em que 1 é o grau mais alto na ordem de preferência. O número de preferência não pode ser maior do que o número de cópias do banco de dados da caixa de correio.

Type:UInt32
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

-ConfigurationOnly

A opção ConfigurationOnly permite que cópias de banco de dados sejam adicionadas sem invocar a semente automática. Não é preciso especificar um valor com essa opção.

O banco de dados de origem não precisa estar online ou presente ao usar esse parâmetro. Ele criará um novo banco de dados do Active Directory sem contatar o servidor de destino. Esse parâmetro pode ser útil em situações em que o servidor de destino está desativado para manutenção e a nova cópia do banco de dados ainda não existe no servidor de destino.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to: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

-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.

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

-Identity

O parâmetro Identity especifica o banco de dados da caixa de correio que está sendo copiado. É possível usar qualquer valor que identifique o banco de dados com exclusividade. Por exemplo:

  • Nome
  • DN (nome diferenciado)
  • GUID
Type:DatabaseIdParameter
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-MailboxServer

O parâmetro MailboxServer especifica o nome do servidor que hospedará a cópia do banco de dados. Este servidor deve ser membro do mesmo DAG e não deve já hospedar uma cópia do banco de dados.

Type:MailboxServerIdParameter
Position:2
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-ReplayLagMaxDelay

O parâmetro ReplayLagMaxDelay especifica o atraso máximo para a reprodução de cópia de banco de dados defasada (também conhecida como reprodução de cópia defasada adiada). Se a latência de IO de leitura do disco for maior que 25 ms, a reprodução de cópia defasada será atrasada até o valor desse parâmetro.

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 padrão é 24:00:00 (24 horas). Para desabilitar a reprodução de cópia defasada adiada, especifique o valor 00:00:00.

Observe que quando o disco está ficando sem espaço, o valor desse parâmetro é ignorado e a reprodução de cópia defasada ocorre sem demora.

Type:EnhancedTimeSpan
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019

-ReplayLagTime

O parâmetro ReplayLagTime especifica a quantidade de tempo que o serviço Microsoft Replicação do Exchange aguarda antes de reproduzir arquivos de log copiados para a cópia do banco de dados.

Para especificar um valor, insira-o como um período de tempo: dd.hh:mm:ss em que dd = dias, hh = horas, mm = minutos e ss = segundos.

O valor padrão é 00.00:00:00, que especifica que não há nenhum atraso de truncamento. O valor máximo é 14,00:00:00 (14 dias).

Type:EnhancedTimeSpan
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

-SeedingPostponed

O comutador SeedingPostponed especifica que a tarefa não semeia a cópia do banco de dados, portanto, você precisa semear explicitamente a cópia do banco de dados. Não é preciso especificar um valor com essa opção.

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

-TruncationLagTime

O parâmetro TruncationLagTime especifica a quantidade de tempo que o serviço Microsoft Replicação do Exchange aguarda antes de truncar arquivos de log que foram reproduzidos em uma cópia do banco de dados. O período é iniciado depois do log ser repetido com êxito na cópia do banco de dados.

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 padrão é 00.00:00:00, que especifica que não há nenhum atraso de truncamento. O valor máximo é 14,00:00:00 (14 dias).

Type:EnhancedTimeSpan
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.