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.