New-MailboxRestoreRequest
Este cmdlet está disponível no Exchange local e no serviço baseado na nuvem. Alguns parâmetros e configurações podem ser exclusivos de um ou outro ambiente.
Use o cmdlet New-MailboxRestoreRequest para recuperar uma caixa de correio excluída por software ou desconectada. Esse cmdlet inicia o processo de mover o conteúdo da caixa de correio excluída por software, da caixa de correio desabilitada, ou de qualquer caixa de correio em um banco de dados de recuperação para uma caixa de correio primária ou de arquivamento conectada.
As propriedades usadas para encontrar caixas de correio desconectadas e restaurar uma caixa de correio são diferentes em Exchange Server e Exchange Online. Para obter mais informações sobre Exchange Online, consulte Restaurar uma caixa de correio inativa.
Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.
Syntax
New-MailboxRestoreRequest
-SourceDatabase <DatabaseIdParameter>
-SourceStoreMailbox <StoreMailboxIdParameter>
-TargetMailbox <MailboxOrMailUserIdParameter>
[-AcceptLargeDataLoss]
[-AllowLegacyDNMismatch]
[-AssociatedMessagesCopyOption <FAICopyOption>]
[-BadItemLimit <Unlimited>]
[-BatchName <String>]
[-Confirm]
[-ConflictResolutionOption <ConflictResolutionOption>]
[-DomainController <Fqdn>]
[-ExcludeDumpster]
[-ExcludeFolders <String[]>]
[-IncludeFolders <String[]>]
[-MRSServer <Fqdn>]
[-Name <String>]
[-Priority <RequestPriority>]
[-SourceRootFolder <String>]
[-SuspendComment <String>]
[-Suspend]
[-TargetIsArchive]
[-TargetRootFolder <String>]
[-WhatIf]
[<CommonParameters>] New-MailboxRestoreRequest
-SourceEndpoint <MigrationEndpointIdParameter>
-SourceExchangeGuid <Guid>
-SourceTenant <SmtpDomain>
-TargetMailbox <MailboxLocationIdParameter>
[-AcceptLargeDataLoss]
[-AllowLegacyDNMismatch]
[-AssociatedMessagesCopyOption <FAICopyOption>]
[-BadItemLimit <Unlimited>]
[-BatchName <String>]
[-CompletedRequestAgeLimit <Unlimited>]
[-Confirm]
[-ConflictResolutionOption <ConflictResolutionOption>]
[-ContentFilter <String>]
[-ContentFilterLanguage <CultureInfo>]
[-CrossTenantRestore]
[-DomainController <Fqdn>]
[-ExcludeDumpster]
[-ExcludeFolders <String[]>]
[-IncludeFolders <String[]>]
[-LargeItemLimit <Unlimited>]
[-Name <String>]
[-SkipMerging <SkippableMergeComponent[]>]
[-SourceRootFolder <String>]
[-SuspendComment <String>]
[-Suspend]
[-TargetIsArchive]
[-TargetRootFolder <String>]
[-TargetType <TargetTypeComponent>]
[-WhatIf]
[<CommonParameters>] New-MailboxRestoreRequest
-SourceDatabase <DatabaseIdParameter>
-SourceStoreMailbox <StoreMailboxIdParameter>>
[-AcceptLargeDataLoss]
[-AllowLegacyDNMismatch]
[-AssociatedMessagesCopyOption <FAICopyOption>]
[-BadItemLimit <Unlimited>]
[-BatchName <String>]
[-CompletedRequestAgeLimit <Unlimited>]
[-Confirm]
[-ConflictResolutionOption <ConflictResolutionOption>]
[-ContentFilter <String>]
[-ContentFilterLanguage <CultureInfo>]
[-DomainController <Fqdn>]
[-ExcludeDumpster]
[-ExcludeFolders <String[]>]
[-IncludeFolders <String[]>]
[-InternalFlags <InternalMrsFlag[]>]
[-LargeItemLimit <Unlimited>]
[-Name <String>]
[-Priority <RequestPriority>]
[-RequestExpiryInterval <Unlimited>]
[-SkipMerging <SkippableMergeComponent[]>]
[-SourceRootFolder <String>]
[-Suspend]
[-SuspendComment <String>]
[-TargetIsArchive]
[-TargetRootFolder <String>]
[-TargetType <TargetTypeComponent>]
[-WhatIf]
[-WorkloadType <RequestWorkloadType>]
[<CommonParameters>] New-MailboxRestoreRequest
-SourceStoreMailbox <StoreMailboxIdParameter>
-TargetMailbox <MailboxLocationIdParameter>
[-AcceptLargeDataLoss]
[-AllowLegacyDNMismatch]
[-AssociatedMessagesCopyOption <FAICopyOption>]
[-BadItemLimit <Unlimited>]
[-BatchName <String>]
[-CompletedRequestAgeLimit <Unlimited>]
[-Confirm]
[-ConflictResolutionOption <ConflictResolutionOption>]
[-ContentFilter <String>]
[-ContentFilterLanguage <CultureInfo>]
[-DomainController <Fqdn>]
[-ExcludeDumpster]
[-ExcludeFolders <String[]>]
[-IncludeFolders <String[]>]
[-InternalFlags <InternalMrsFlag[]>]
[-LargeItemLimit <Unlimited>]
[-Name <String>]
[-Priority <RequestPriority>]
[-RequestExpiryInterval <Unlimited>]
[-SkipMerging <SkippableMergeComponent[]>]
[-SourceRootFolder <String>]
[-Suspend]
[-SuspendComment <String>]
[-TargetIsArchive]
[-TargetRootFolder <String>]
[-TargetType <TargetTypeComponent>]
[-WhatIf]
[-WorkloadType <RequestWorkloadType>]
[<CommonParameters>] New-MailboxRestoreRequest
-SourceStoreMailbox <StoreMailboxIdParameter>
-TargetMailbox <MailboxOrMailUserIdParameter>
[-AcceptLargeDataLoss]
[-AllowLegacyDNMismatch]
[-AssociatedMessagesCopyOption <FAICopyOption>]
[-BadItemLimit <Unlimited>]
[-BatchName <String>]
[-CompletedRequestAgeLimit <Unlimited>]
[-Confirm]
[-ConflictResolutionOption <ConflictResolutionOption>]
[-DomainController <Fqdn>]
[-ExcludeDumpster]
[-ExcludeFolders <String[]>]
[-IncludeFolders <String[]>]
[-InternalFlags <InternalMrsFlag[]>]
[-LargeItemLimit <Unlimited>]
[-Name <String>]
[-Priority <RequestPriority>]
[-SkipMerging <SkippableMergeComponent[]>]
[-SourceRootFolder <String>]
[-Suspend]
[-SuspendComment <String>]
[-TargetIsArchive]
[-TargetRootFolder <String>]
[-WhatIf]
[-WorkloadType <RequestWorkloadType>]
[<CommonParameters>] New-MailboxRestoreRequest
-RemoteDatabaseGuid <Guid>
-RemoteHostName <Fqdn>
-RemoteRestoreType <RemoteRestoreType>
-RemoteCredential <PSCredential>
-SourceMailbox <MailboxLocationIdParameter>
-TargetMailbox <MailboxLocationIdParameter>
[-AcceptLargeDataLoss]
[-AllowLegacyDNMismatch]
[-AssociatedMessagesCopyOption <FAICopyOption>]
[-BadItemLimit <Unlimited>]
[-BatchName <String>]
[-CompletedRequestAgeLimit <Unlimited>]
[-Confirm]
[-ConflictResolutionOption <ConflictResolutionOption>]
[-ContentFilter <String>]
[-ContentFilterLanguage <CultureInfo>]
[-DomainController <Fqdn>]
[-ExcludeDumpster]
[-ExcludeFolders <String[]>]
[-IncludeFolders <String[]>]
[-InternalFlags <InternalMrsFlag[]>]
[-LargeItemLimit <Unlimited>]
[-Name <String>]
[-Priority <RequestPriority>]
[-RequestExpiryInterval <Unlimited>]
[-SkipMerging <SkippableMergeComponent[]>]
[-SourceIsArchive]
[-SourceRootFolder <String>]
[-Suspend]
[-SuspendComment <String>]
[-TargetIsArchive]
[-TargetRootFolder <String>]
[-TargetType <TargetTypeComponent>]
[-WhatIf]
[-WorkloadType <RequestWorkloadType>]
[<CommonParameters>] Description
Quando as caixas de correio são movidas de um banco de dados para outro, o Exchange não exclui totalmente a caixa de correio do banco de dados de origem imediatamente após a conclusão da mudança. Ao contrário, a caixa de correio no banco de dados da caixa de correio de origem é alternada para um estado de software excluído, que permite os dados da caixa de correio sejam acessados durante uma operação de restauração de caixa de correio usando o novo conjunto de cmdlets MailboxRestoreRequest. As caixas de correio excluídas por software são mantidas no banco de dados de origem até que o período de retenção da caixa de correio excluída expire ou você use o cmdlet Remove-StoreMailbox para limpar a caixa de correio.
Para exibir caixas de correio excluídas por software, execute o cmdlet Get-MailboxStatistics em relação a um banco de dados e procure por resultados que possuam um DisconnectReason com valor de SoftDeleted. Para obter mais informações, consulte "Exemplo 1", posteriormente neste tópico.
Uma caixa de correio é marcada como Desabilitada pouco depois que o comando Disable-Mailbox ou Remove-Mailbox for concluído.
A caixa de correio não será marcada como Desabilitada até que o serviço microsoft Exchange Information Store determine que o Active Directory foi atualizado com as informações da caixa de correio desabilitada. Você pode acelerar o processo executando o cmdlet Update-StoreMailboxState em relação ao banco de dados.
O Exchange retém caixas de correio desabilitadas no banco de dados da caixa de correio com base nas configurações de retenção de caixa de correio excluídas configuradas para esse banco de dados de caixa de correio. Depois de um tempo especificado, a caixa de correio é excluída permanentemente.
Para exibir caixas de correio desabilitadas, execute o cmdlet Get-MailboxStatistics em relação a um banco de dados e procure por resultados que possuam um DisconnectReason com valor de Disabled. Para obter mais informações, confira Exemplos 2 e 3 posteriores neste tópico.
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.
Observação: para restaurar o conteúdo de uma caixa de correio primária para uma caixa de correio de arquivo, use o parâmetro TargetRootFolder 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.
Exemplos
Exemplo 1
Get-MailboxStatistics -Database MBD01 | Where {$_.DisconnectReason -eq "SoftDeleted" -or $_.DisconnectReason -eq "Disabled"} | Format-List LegacyExchangeDN,DisplayName,MailboxGUID, DisconnectReason
New-MailboxRestoreRequest -SourceDatabase "MBD01" -SourceStoreMailbox 1d20855f-fd54-4681-98e6-e249f7326ddd -TargetMailbox AylaNo Exchange local, este exemplo usa o cmdlet Get-MailboxStatistics para retornar o DisplayName, LegacyExchangeDN e MailboxGUID (valores válidos de identidade de caixa de correio de origem) para todas as caixas de correio no banco de dados de caixa de correio chamado MBD01 que têm um motivo de desconexão de SoftDeleted ou Disabled.
Usando essas informações, a caixa de correio de origem com o valor MailboxGUID 1d20855f-fd54-4681-98e6-e249f7326ddd é restaurada para a caixa de correio de destino que tem o valor Ayla do Alias.
Exemplo 2
New-MailboxRestoreRequest -SourceDatabase "MBD01" -SourceStoreMailbox "Tony Smith" -TargetMailbox Tony@contoso.com -TargetIsArchiveNo Exchange local, este exemplo restaura o conteúdo da caixa de correio de origem com o DisplayName de Tony Smith no banco de dados de caixa de correio MBD01 na caixa de correio de arquivo para Tony@contoso.com.
Parâmetros
-AcceptLargeDataLoss
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á.
| 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, Exchange Online |
-AllowLegacyDNMismatch
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.
| 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, Exchange Online |
-AssociatedMessagesCopyOption
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.
| Type: | FAICopyOption |
| 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, Exchange Online |
-BadItemLimit
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.
| Type: | Unlimited |
| 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, Exchange Online |
-BatchName
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.
| Type: | String |
| 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, Exchange Online |
-CompletedRequestAgeLimit
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.
| Type: | Unlimited |
| 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, Exchange Online |
-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, Exchange Online |
-ConflictResolutionOption
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
| Type: | ConflictResolutionOption |
| Position: | Named |
| Default value: | KeepSourceItem |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-ContentFilter
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-likepara 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, use500,$true,$falseou$nullem 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.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-ContentFilterLanguage
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.
| Type: | CultureInfo |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-CrossTenantRestore
Esse parâmetro só está disponível no serviço baseado em nuvem.
Esse parâmetro está reservado para uso interno da Microsoft.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-DomainController
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.
| 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, Exchange Online |
-ExcludeDumpster
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
| 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, Exchange Online |
-ExcludeFolders
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\#.
| Type: | String[] |
| 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, Exchange Online |
-IncludeFolders
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\#.
| Type: | String[] |
| 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, Exchange Online |
-InternalFlags
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.
| Type: | InternalMrsFlag[] |
| 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 |
-LargeItemLimit
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.
| Type: | Unlimited |
| 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, Exchange Online |
-MRSServer
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.
| Type: | Fqdn |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010 |
-Name
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).
| Type: | String |
| 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, Exchange Online |
-Priority
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
| Type: | RequestPriority |
| 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 |
-RemoteCredential
Esse parâmetro só está disponível no serviço baseado em nuvem.
Esse parâmetro está reservado para uso interno da Microsoft.
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-RemoteDatabaseGuid
Esse parâmetro só está disponível no serviço baseado em nuvem.
Esse parâmetro está reservado para uso interno da Microsoft.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-RemoteHostName
Esse parâmetro só está disponível no serviço baseado em nuvem.
Esse parâmetro está reservado para uso interno da Microsoft.
| Type: | Fqdn |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-RemoteRestoreType
Esse parâmetro só está disponível no serviço baseado em nuvem.
Esse parâmetro está reservado para uso interno da Microsoft.
| Type: | RemoteRestoreType |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-RequestExpiryInterval
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.
| Type: | Unlimited |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019 |
-SkipMerging
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.
| Type: | SkippableMergeComponent[] |
| 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, Exchange Online |
-SourceDatabase
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
| Type: | DatabaseIdParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-SourceEndpoint
Esse parâmetro só está disponível no serviço baseado em nuvem.
Esse parâmetro está reservado para uso interno da Microsoft.
| Type: | MigrationEndpointIdParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-SourceExchangeGuid
Esse parâmetro só está disponível no serviço baseado em nuvem.
Esse parâmetro está reservado para uso interno da Microsoft.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-SourceIsArchive
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.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019, Exchange Online |
-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.
| Type: | SourceMailbox |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019, Exchange Online |
-SourceRootFolder
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.
| Type: | String |
| 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, Exchange Online |
-SourceStoreMailbox
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.
| Type: | StoreMailboxIdParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-SourceTenant
Esse parâmetro só está disponível no serviço baseado em nuvem.
Esse parâmetro está reservado para uso interno da Microsoft.
| Type: | SmtpDomain |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-Suspend
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.
| 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, Exchange Online |
-SuspendComment
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.
| Type: | String |
| 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, Exchange Online |
-TargetIsArchive
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.
| 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, Exchange Online |
-TargetMailbox
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.
| Type: | MailboxLocationIdParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019, Exchange Online |
-TargetRootFolder
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.
| Type: | String |
| 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, Exchange Online |
-TargetType
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)
| Type: | TargetTypeComponent |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019, Exchange Online |
-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, Exchange Online |
-WorkloadType
Este parâmetro está disponível somente no Exchange local.
Esse parâmetro está reservado para uso interno da Microsoft.
| Type: | RequestWorkloadType |
| 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 |
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.