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.

Sintaxe

Default (Default)

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 que a cópia do banco de dados da caixa de correio for adicionada, 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 de banco de dados é definido como Suspenso, o SuspendMessage é definido como "A replicação é suspensa para cópia de banco de dados '{0}' porque o banco de dados precisa ser propagado".

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

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 retardo de repetição e o tempo de retardo 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

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

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.

Propriedades do parâmetro

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

-ConfigurationOnly

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

A opção ConfigurationOnly permite que cópias de banco de dados sejam adicionadas sem invocar a propagação 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 cria um novo banco de dados no Active Directory sem entrar em contato com o servidor de destino. Esse parâmetro pode ser útil em situações em que o servidor de destino está inativo para manutenção e a nova cópia do banco de dados ainda não existe no servidor de destino.

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

-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

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

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

-Identity

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

O parâmetro Identity especifica o banco de dados de 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

Propriedades do parâmetro

Tipo:DatabaseIdParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:1
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-MailboxServer

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

O parâmetro MailboxServer especifica o nome do servidor que hospeda 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.

Propriedades do parâmetro

Tipo:MailboxServerIdParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:2
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-ReplayLagMaxDelay

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

O parâmetro ReplayLagMaxDelay especifica o atraso máximo para a reprodução de cópia de banco de dados com retardo (também conhecido como reprodução de cópia com retardamento adiado). Se a latência de E/S de leitura do disco for maior que 25 ms, a reprodução de cópia com retardamento 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 com retardo adiado, especifique o valor 00:00:00.

Quando o disco está ficando sem espaço, o valor desse parâmetro é ignorado e a reprodução de cópia com retardamento ocorre sem demora.

Propriedades do parâmetro

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

-ReplayLagTime

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

O parâmetro ReplayLagTime especifica a quantidade de tempo que o serviço de Replicação do Microsoft Exchange aguarda antes de reproduzir arquivos de log que foram copiados para a cópia de 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).

Propriedades do parâmetro

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

-SeedingPostponed

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

A opção SeedingPostponed especifica que a tarefa não propaga a cópia do banco de dados, portanto, você precisa propagar explicitamente a cópia do banco de dados. 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

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

-TruncationLagTime

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

O parâmetro TruncationLagTime especifica a quantidade de tempo que o serviço de Replicação do Microsoft Exchange aguarda antes de truncar os arquivos de log que foram reproduzidos em uma cópia do banco de dados. O período começa depois que o log é reproduzido 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).

Propriedades do parâmetro

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