New-MailboxRestoreRequest

A opção AcceptLargeDataLoss especifica que a solicitação deve continuar, mesmo quando um grande número de itens na caixa de correio de origem não pode ser copiado para a caixa de correio de destino. Não é preciso especificar um valor com essa opção.

No Exchange 2013 ou posterior ou no Exchange Online, você precisa usar essa opção se definir o parâmetro LargeItemLimit para um valor de 51 ou superior. Caso contrário, o comando falhará.

No Exchange 2010, você precisa usar essa opção se definir o parâmetro BadItemLimit para um valor de 51 ou superior. Caso contrário, o comando falhará.

O comutador AllowLegacyDNMismatch especifica que a operação deve continuar se o LegacyExchangeDN da caixa de correio física de origem e a caixa de correio de destino não corresponderem. Não é preciso especificar um valor com essa opção.

Por padrão, esse cmdlet executa uma verificação para se certificar de que o LegacyExchangeDN na caixa de correio física está presente no usuário de destino no formato de LegacyExchangeDN ou de um endereço proxy X500 que corresponda ao LegacyExchangeDN. Essa verificação evita que você restaure acidentalmente uma caixa de correio de origem na caixa de correio de destino incorreta.

Observação: esse parâmetro está sendo substituído no serviço baseado em nuvem. Para concluir uma solicitação de restauração de caixa de correio para caixas de correio com um LegacyExchangeDN que não corresponde, você precisa obter o valor LegacyExchangeDN para a caixa de correio de origem e adicioná-lo à caixa de correio de destino como um endereço proxy X500. Para obter instruções detalhadas, consulte Restaurar uma caixa de correio inativa.

O parâmetro AssociatedMessagesCopyOption especifica se as mensagens associadas são copiadas quando a solicitação é processada. As mensagens associadas são mensagens especiais que contêm dados ocultos com informações sobre regras, exibições e formulários. Os valores válidos são:

• DoNotCopy: as mensagens associadas não são copiadas.
• MapByMessageClass: localize a mensagem associada pesquisando o atributo MessageClass da mensagem de origem. Se houver uma mensagem associada desta classe em ambas as pastas de origem e de destino, ela sobrescreve a mensagem associada no destino. Se não houver mensagem associada no destino, ela cria uma cópia no destino.
• Copiar: copiar mensagens associadas da origem para o destino. Se o mesmo tipo de mensagem existir em ambos os locais de origem e de destino, estas mensagens associadas serão duplicadas. Esse é o valor padrão.

Copy: esta opção copia as mensagens associadas da origem para o destino. Se o mesmo tipo de mensagem existir em ambos os locais de origem e de destino, estas mensagens associadas serão duplicadas. Esta é a opção padrão.

O parâmetro BadItemLimit especifica o número máximo de itens inválidos permitido antes que a solicitação falhe. Um item inválido é um item corrompido na caixa de correio de origem que não pode ser copiado para a caixa de correio de destino. Os itens ausentes também estão incluídos no limite de itens inválidos. Os itens ausentes são itens na caixa de correio de origem que não podem ser encontrados na caixa de correio de destino quando a solicitação está pronta para ser concluída.

Uma entrada válida para esse parâmetro é um número inteiro ou o valor ilimitado. O valor padrão é 0, o que significa que a solicitação falhará se algum item inválido for detectado. Se você não se importar em deixar alguns itens inválidos para trás, poderá definir esse parâmetro com um valor razoável (recomendamos 10 ou menos), de forma que a solicitação possa prosseguir. Se muitos itens inválidos forem detectados, considere o uso do cmdlet New-MailboxRepairRequest para tentar corrigir itens corrompidos na caixa de correio de origem e repita a solicitação.

No Exchange 2010, se você definir esse valor como 51 ou superior, também precisará usar a opção AcceptLargeDataLoss. Caso contrário, o comando falhará.

Observação: esse parâmetro está sendo substituído no serviço baseado em nuvem. No futuro, se você não usar esse parâmetro, será usada a semântica de aprovação de Itens Ignorados.

O parâmetro BatchName especifica um nome descritivo para restaurar um lote de caixas de correio. Você pode usar o nome no parâmetro BatchName como uma pesquisa de cadeia de caracteres ao usar o cmdlet Get-MailboxRestoreRequest.

O parâmetro CompletedRequestAgeLimit especifica por quanto tempo o status de uma solicitação de restauração finalizada é definida como Completed. Se este parâmetro estiver definido com o valor de 0, o status é apagado imediatamente ao invés de ser alterado para Completed.

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.

O parâmetro ConflictResolutionOption especifica o que fazer se houver várias mensagens correspondentes no destino. Os valores válidos são:

• ForceCopy
• KeepAll
• KeepLatestItem
• KeepLatestItem
• KeepTargetItem
• UpdateFromSource

Esse parâmetro só está disponível no serviço baseado em nuvem.

O parâmetro ContentFilter usa a sintaxe de filtro OPATH para filtrar os resultados pelas propriedades e valores especificados. Somente o conteúdo que corresponde ao parâmetro ContentFilter será restaurado. Os critérios de pesquisa usam a sintaxe "Property -ComparisonOperator 'Value'".

• Inclua todo o filtro OPATH nas aspas duplas " ". Se o filtro contiver valores do sistema (por exemplo, $true, $falseou $null), use aspas individuais ' ' em vez disso. Embora esse parâmetro seja uma cadeia de caracteres (não um bloco do sistema), você também pode usar chaves { }, mas somente se o filtro não contiver variáveis.
• A propriedade é uma propriedade filtrada. Para propriedades filtradas, consulte Propriedades filtradas para o parâmetro ContentFilter.
• ComparisonOperator é um operador de comparação OPATH (por exemplo -eq , para iguais e -like para comparação de cadeia de caracteres). Para obter mais informações sobre operadores de comparação, consulte about_Comparison_Operators.
• Valor é o valor da propriedade a ser pesquisado. Inclua valores e variáveis de texto em aspas individuais ('Value' ou '$Variable'). Se um valor variável contiver aspas individuais, você precisará identificar (escapar) as aspas individuais para expandir a variável corretamente. Por exemplo, em vez de '$User', use '$($User -Replace "'","''")'. Não inclua inteiros ou valores do sistema entre aspas (por exemplo, use 500, $true, $falseou $null em vez disso).

Você pode encadear vários critérios de pesquisa usando os operadores lógicos -and e -or. Por exemplo: "Criteria1 -and Criteria2" ou "(Criteria1 -and Criteria2) -or Criteria3".

Para obter informações detalhadas sobre filtros OPATH no Exchange, consulte Informações adicionais de sintaxe OPATH.

Esse parâmetro só está disponível no serviço baseado em nuvem.

O parâmetro ContentFilterLanguage especifica o idioma que é usado no parâmetro ContentFilter para pesquisas de cadeia de caracteres.

A entrada válida para esse parâmetro é um valor de código de cultura com suporte da classe Microsoft .NET Framework CultureInfo. Por exemplo, da-DK para dinamarquês ou ja-JP para japonês. Para obter mais informações, consulte Classe CultureInfo.

Esse parâmetro só está disponível no serviço baseado em nuvem.

Esse parâmetro está reservado para uso interno da Microsoft.

Esse parâmetro é funcional apenas no Exchange local.

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.

A opção ExcludeDumpster especifica se deve excluir a pasta Itens Recuperáveis. Não é preciso especificar um valor com essa opção.

Se você não usar essa opção, a pasta Itens Recuperáveis será copiada com as seguintes subpastas:

• Exclusões
• Versões
• Limpezas

O parâmetro ExcludeFolders especifica a lista de pastas a serem excluídas durante a solicitação de restauração.

Você precisará definir o parâmetro ImmutableId se o AD FS (Serviços de Federação do exADNoMk) for implantando para permitir o logon único em caixas de correio fora do local e se o AD FS estiver configurado para usar um atributo que não o ExchangeGUID para solicitações de logon de token. Ambos, exExchangeNoVersion e AD FS, devem solicitar o mesmo token para o mesmo usuário a fim de garantir a funcionalidade adequada para um cenário de implantação do exExchangeNoVersion entre locais.

<FolderName>/*: use essa sintaxe para denotar uma pasta pessoal na pasta especificada no parâmetro SourceRootFolder, por exemplo, "MyProjects" ou "MyProjects/FY2010".

#<FolderName>#/*: use essa sintaxe para denotar uma pasta bem conhecida, independentemente do nome da pasta em outro idioma. Por exemplo, #Inbox# indica a pasta Caixa de Entrada, mesmo se a Caixa de Entrada estiver traduzida para Turco, que é Gelen Kutusu. Os tipos de pasta conhecidos incluem os seguintes:

• Caixa de Entrada
• SentItems
• Deleteditems
• Calendário
• Contatos
• Rascunhos
• Diário
• Tarefas
• Observações
• JunkEmail
• CommunicatorHistory
• Caixa postal
• Fax
• Conflitos
• SyncIssues
• LocalFailures
• ServerFailures

Se o usuário criar uma pasta pessoal com o mesmo nome de uma pasta conhecida e o símbolo # ao seu redor, você poderá usar uma barra de fundo (\) como um caractere de escape para especificar essa pasta. Por exemplo, se um usuário criar uma pasta chamada #Notes# e você quiser especificar essa pasta em vez da conhecida pasta Notas, use a seguinte sintaxe: \#Notes\#.

Se o usuário criar uma pasta pessoal com o mesmo nome que uma pasta conhecida e o símbolo # no início e no fim do nome, é possível usar uma barra invertida (\) como um caractere de escape para especificar aquela pasta. Por exemplo, se um usuário cria uma pasta denominada #Notas# e você deseja especificar essa pasta, mas não a pasta Notas conhecida, use a seguinte sintaxe: \#Notes\#.

O parâmetro IncludeFolders especifica a lista de pastas a serem incluídas durante a solicitação de restauração.

Você precisará definir o parâmetro ImmutableId se o AD FS (Serviços de Federação do exADNoMk) for implantando para permitir o logon único em caixas de correio fora do local e se o AD FS estiver configurado para usar um atributo que não o ExchangeGUID para solicitações de logon de token. Ambos, exExchangeNoVersion e AD FS, devem solicitar o mesmo token para o mesmo usuário a fim de garantir a funcionalidade adequada para um cenário de implantação do exExchangeNoVersion entre locais.

<FolderName>/*: use essa sintaxe para denotar uma pasta pessoal na pasta especificada no parâmetro SourceRootFolder, por exemplo, "MyProjects" ou "MyProjects/FY2010".

#<FolderName>#/*: use essa sintaxe para denotar uma pasta bem conhecida, independentemente do nome da pasta em outro idioma. Por exemplo, #Inbox# indica a pasta Caixa de Entrada, mesmo se a Caixa de Entrada estiver traduzida para Turco, que é Gelen Kutusu. Os tipos de pasta conhecidos incluem os seguintes:

• Caixa de Entrada
• SentItems
• Deleteditems
• Calendário
• Contatos
• Rascunhos
• Diário
• Tarefas
• Observações
• JunkEmail
• CommunicationHistory
• Caixa postal
• Fax
• Conflitos
• SyncIssues
• LocalFailures
• ServerFailures

Se o usuário criar uma pasta pessoal com o mesmo nome de uma pasta conhecida e o símbolo # ao seu redor, você poderá usar uma barra de fundo (\) como um caractere de escape para especificar essa pasta. Por exemplo, se um usuário criar uma pasta chamada #Notes# e você quiser especificar essa pasta em vez da conhecida pasta Notas, use a seguinte sintaxe: \#Notes\#.

Se o usuário criar uma pasta pessoal com o mesmo nome que uma pasta conhecida e o símbolo # no início e no fim do nome, é possível usar uma barra invertida (\) como um caractere de escape para especificar aquela pasta. Por exemplo, se um usuário cria uma pasta denominada #Notas# e você deseja especificar essa pasta, mas não a pasta Notas conhecida, use a seguinte sintaxe: \#Notes\#.

Este parâmetro está disponível somente no Exchange local.

O parâmetro InternalFlags especifica as etapas opcionais na solicitação. Esse parâmetro é usado principalmente para fins de depuração.

O parâmetro LargeItemLimit especifica o número máximo de itens grandes permitido antes que a solicitação falhe. Um item grande é uma mensagem na caixa de correio de origem que excede o tamanho máximo de mensagem permitido na caixa de correio de destino. Se a caixa de correio de destino não possuir um valor de tamanho de mensagem máximo especificamente configurado, será usado o valor da organização.

Para saber mais sobre valores máximos de tamanho de mensagem, confira os seguintes tópicos:

• Exchange 2016: limites de tamanho da mensagem em Exchange Server
• Exchange Online: Limites do Exchange Online

Uma entrada válida para esse parâmetro é um número inteiro ou o valor ilimitado. O valor padrão é 0, o que significa que a solicitação falhará se algum item grande for detectado. Se você não se importar em deixar alguns itens grandes para trás, poderá definir esse parâmetro com um valor razoável (recomendamos 10 ou menos), de forma que a solicitação possa prosseguir.

Se você definir esse valor como 51 ou superior, também precisará usar a opção AcceptLargeDataLoss. Caso contrário, o comando falhará.

Observação: esse parâmetro está sendo substituído no serviço baseado em nuvem. No futuro, se você não usar esse parâmetro, será usada a semântica de aprovação de Itens Ignorados.

Esse parâmetro só está disponível no Exchange Server 2010.

O parâmetro MRSServer especifica o FQDN do servidor de Acesso para Cliente no qual a instância do MRS do Microsoft Exchange está sendo executada. Esse parâmetro é usado somente para fins de depuração. Use-o somente se receber instruções para fazer isso do pessoal de suporte.

O parâmetro Name especifica o nome da solicitação específica em objetivos de exibição e rastreamento. Como você pode ter várias solicitações de restauração por caixa de correio, o Exchange precede o nome com o alias da caixa de correio. Por exemplo, se você criar uma solicitação de exportação na caixa de correio de um usuário que possua o alias Kweku e especificar o valor deste parâmetro como RestoreFailedMoves, a identidade desta solicitação de exportação será Kweku\PC1toArchive.

Se você não especificou um nome para a solicitação de restauração quando ela foi criada, o Exchange gerará automaticamente o nome padrão MailboxRestore. O Exchange gera até 10 nomes, começando com MailboxRestore e, em seguida, MailboxRestoreX (onde X = 1-9).

Este parâmetro está disponível somente no Exchange local.

O parâmetro Priority especifica a ordem na qual a solicitação deve ser processada na fila de solicitações. As solicitações são processadas em ordem, com base na integridade do servidor, status, prioridade e hora da última atualização. Os valores de prioridade válidos são:

• Mais Baixo
• Inferior
• Baixo
• Normal (este é o valor padrão.)
• Alta
• Superior
• Mais Alta
• Emergência

Esse parâmetro só está disponível no serviço baseado em nuvem.

Esse parâmetro está reservado para uso interno da Microsoft.

Esse parâmetro só está disponível no serviço baseado em nuvem.

Esse parâmetro está reservado para uso interno da Microsoft.

Esse parâmetro só está disponível no serviço baseado em nuvem.

Esse parâmetro está reservado para uso interno da Microsoft.

Esse parâmetro só está disponível no serviço baseado em nuvem.

Esse parâmetro está reservado para uso interno da Microsoft.

Este parâmetro está disponível somente no Exchange local.

O parâmetro RequestExpiryInterval especifica um limite de idade para uma solicitação concluída ou com falha. Quando você usa esse parâmetro, a solicitação concluída ou que falhou é removida automaticamente depois que o intervalo especificado expira. Se você não usar esse parâmetro:

• A solicitação concluída será removida automaticamente com base no valor de parâmetro CompletedRequestAgeLimit.
• Se a solicitação falhar, você precisará removê-la manualmente usando o cmdlet Remove-*Request correspondente.

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.

Quando você usa o valor Unlimited, a solicitação concluída não é removida automaticamente.

O parâmetro SkipMerging especifica os itens relacionados às pastas a serem ignorados na restauração da caixa de correio. Use um dos valores a seguir:

• FolderACLs
• Folderproperties
• FolderRules
• InitialConnectionValidation

Use este parâmetro somente se uma solicitação de restauração falhar por causa de regras da pasta, listas de controle de acesso (ACLs) da pasta ou validação inicial de conexão.

Este parâmetro está disponível somente no Exchange local.

O parâmetro SourceDatabase especifica a identidade do banco de dados do qual você está restaurando a caixa de correio excluída por software ou desconectada. É possível usar qualquer valor que identifique o banco de dados com exclusividade. Por exemplo:

• Nome
• DN (nome diferenciado)
• GUID

Esse parâmetro só está disponível no serviço baseado em nuvem.

Esse parâmetro está reservado para uso interno da Microsoft.

Esse parâmetro só está disponível no serviço baseado em nuvem.

Esse parâmetro está reservado para uso interno da Microsoft.

A opção SourceIsArchive especifica que a caixa de correio de origem é uma caixa de correio de arquivo morto. Não é preciso especificar um valor com essa opção.

Você só poderá usar essa opção com o parâmetro SourceMailbox.

O parâmetro SourceMailbox especifica a caixa de correio excluída de forma reversível que você deseja restaurar. A melhor maneira de identificar a caixa de correio excluída é pelo seu valor GUID. Você pode encontrar o valor de GUID executando o seguinte comando: Get-Mailbox -SoftDeletedMailbox.

O parâmetro SourceRootFolder especifica a pasta raiz da caixa de correio da qual os dados são restaurados. Se este parâmetro não for especificado, o comando restaura todas as pastas.

Esse parâmetro é funcional apenas no Exchange local.

O parâmetro SourceStoreMailbox especifica o MailboxGUID da caixa de correio de origem da qual você deseja restaurar o conteúdo.

Você pode encontrar o MailboxGUID executando o cmdlet Get-MailboxStatistics.

Esse parâmetro só está disponível no serviço baseado em nuvem.

Esse parâmetro está reservado para uso interno da Microsoft.

A opção Suspend especifica se deve suspender a solicitação. Não é preciso especificar um valor com essa opção.

Caso use essa opção, a solicitação é colocada em fila, mas só vai alcançar o status InProgress quando você retomar a solicitação com o cmdlet de resumo relevante.

O parâmetro SuspendComment especifica uma descrição do motivo pelo qual a solicitação foi suspensa. Só é possível usar esse parâmetro se o parâmetro Suspend for especificado.

A opção TargetIsArchive especifica que o conteúdo é restaurado no arquivo da caixa de correio de destino especificada. Não é preciso especificar um valor com essa opção.

O parâmetro TargetMailbox especifica o GUID da caixa de correio de destino ou do usuário de email no qual você deseja restaurar o conteúdo. O usuário da caixa de correio de destino ou da caixa postal deve existir antes que você possa executar esse comando com sucesso.

Você pode encontrar o valor GUID para a caixa de correio ou usuário de email executando os cmdlets Get-Mailbox ou Get-MailUser.

No Exchange 2016 ou posterior e Exchange Online, esse parâmetro é o tipo MailboxLocationIdParameter.

No Exchange 2013 ou anterior, esse parâmetro é o tipo MailboxOrMailUserIdParameter.

O parâmetro TargetRootFolder especifica a pasta de nível superior na qual deseja restaurar dados. Se você não especificar este parâmetro, o comando irá restaurar as pastas para o topo da estrutura de pasta na caixa de correio ou arquivo de destino. O conteúdo é mesclado sob as pastas existentes e as novas pastas são criadas se elas já não existirem na estrutura de pasta de destino.

Observação: para restaurar o conteúdo de uma caixa de correio primária para uma caixa de correio de arquivo, use esse parâmetro para especificar as pastas de caixa de correio de arquivo para as quais migrar o conteúdo. Esse conteúdo ficará visível depois de restaurado. Se você não usar esse parâmetro, o conteúdo restaurado não estará visível porque ele é mapeado para locais na caixa de correio de arquivo que não estão visíveis para os usuários.

O parâmetro TargetType especifica o tipo de caixa de correio que é o destino da operação de restauração. Os valores válidos são:

• Arquivar
• MailboxLocation
• Primário (este é o valor padrão)

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.

Este parâmetro está disponível somente no Exchange local.

Esse parâmetro está reservado para uso interno da Microsoft.