New-MailboxRestoreRequest

Sintaxe

Default

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

CrossTenantRestore

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

MigrationLocalMailboxRestore

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

RemoteMailboxRestoreMailboxLocationId

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

RemoteMailboxRestoreMailboxId

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

SourceMailbox

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

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 Ayla

Exemplo 2

New-MailboxRestoreRequest -SourceDatabase "MBD01" -SourceStoreMailbox "Tony Smith" -TargetMailbox Tony@contoso.com -TargetIsArchive

Exemplo 3

New-MailboxRestoreRequest -SourceMailbox 33948c06-c453-48be-bdb9-08eacd466f81 -TargetMailbox Tony@contoso.com -AllowLegacyDNMismatch

Parâmetros

-AcceptLargeDataLoss

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

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, você precisará usar essa opção se definir o parâmetro LargeItemLimit como 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á.

No Exchange Online, essa opção não tem dependência dos parâmetros BadItemLimit ou LargeItemLimit, pois esses parâmetros não estão disponíveis.

Propriedades do parâmetro

Conjuntos de parâmetros

-AllowLegacyDNMismatch

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

A opção AllowLegacyDNMismatch especifica que a operação deve continuar se o LegacyExchangeDN da caixa de correio física de origem e da caixa de correio de destino não corresponder. 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 corresponda, 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.

Propriedades do parâmetro

Conjuntos de parâmetros

-AssociatedMessagesCopyOption

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

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: Copie 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. Esse valor é o 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.

Propriedades do parâmetro

Conjuntos de parâmetros

-BadItemLimit

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

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

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 foi preterido no serviço baseado em nuvem. Em vez disso, a Pontuação de Consistência de Dados é usada e os administradores de locatários devem revisar o DataConsistencyScore e todos os itens ignorados após a conclusão da restauração.

Propriedades do parâmetro

Conjuntos de parâmetros

-BatchName

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

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.

Propriedades do parâmetro

Conjuntos de parâmetros

-CompletedRequestAgeLimit

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

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.

Propriedades do parâmetro

Conjuntos de parâmetros

-Confirm

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

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

Conjuntos de parâmetros

-ConflictResolutionOption

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

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

• ForceCopy
• Manter tudo
• KeepLatestItem
• KeepSourceItem (esse valor é o padrão.)
• KeepTargetItem
• UpdateFromSource

Propriedades do parâmetro

Conjuntos de parâmetros

-ContentFilter

Aplicável: Exchange Online

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 é restaurado. O critério de pesquisa usa a sintaxe "Property -ComparisonOperator 'Value'".

• Coloque todo o filtro OPATH entre aspas duplas " ". Se o filtro contiver valores do sistema (por exemplo, $true, $false, ou $null), use aspas simples " '. Embora esse parâmetro seja uma cadeia de caracteres (não um bloco do sistema), você também poderá usar chaves { }, mas somente se o filtro não contiver variáveis.
• A propriedade é uma propriedade filtrável. Para propriedades filtráveis, consulte Propriedades filtráveis para o parâmetro ContentFilter.
• ComparisonOperator é um operador de comparação OPATH (por exemplo, -eq para igual 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. Coloque os valores de texto e variáveis entre aspas simples ('Value' ou '$Variable'). Se um valor de variável contiver aspas simples, você precisará identificar (escapar) as aspas simples para expandir a variável corretamente. Por exemplo, em vez de '$User', use '$($User -Replace "'","''")'. Não coloque números inteiros ou valores do sistema entre aspas (por exemplo, use 500, $true, $false, ou $null em vez disso).

Você pode encadear vários critérios de pesquisa usando os operadores -and lógicos 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.

Propriedades do parâmetro

Conjuntos de parâmetros

-ContentFilterLanguage

Aplicável: Exchange Online

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 CultureInfo do Microsoft .NET Framework. Por exemplo, da-DK para dinamarquês ou ja-JP para japonês. Para obter mais informações, consulte Classe CultureInfo.

Propriedades do parâmetro

Conjuntos de parâmetros

-CrossTenantRestore

Aplicável: Exchange Online

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

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

Propriedades do parâmetro

Conjuntos de parâmetros

-DomainController

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

Este parâmetro só é funcional 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.

Propriedades do parâmetro

Conjuntos de parâmetros

-ExcludeDumpster

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

A opção ExcludeDumpster especifica se a pasta Itens Recuperáveis deve ser excluída. 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

Propriedades do parâmetro

Conjuntos de parâmetros

-ExcludeFolders

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

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 esta sintaxe para indicar uma pasta pessoal na pasta especificada no parâmetro SourceRootFolder, por exemplo, "MeusProjetos" ou "MeusProjetos/Ano fiscal de 2010".

#<FolderName>#/*: Use esta sintaxe para indicar uma pasta 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
• Lixo eletrônico
• História do Comunicador
• 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 redor dela, você poderá usar uma barra invertida (\) como 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\#.

Propriedades do parâmetro

Conjuntos de parâmetros

-IncludeFolders

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

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 esta sintaxe para indicar uma pasta pessoal na pasta especificada no parâmetro SourceRootFolder, por exemplo, "MeusProjetos" ou "MeusProjetos/Ano fiscal de 2010".

#<FolderName>#/*: Use esta sintaxe para indicar uma pasta 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
• Lixo eletrônico
• 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 redor dela, você poderá usar uma barra invertida (\) como 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\#.

Propriedades do parâmetro

Conjuntos de parâmetros

-InternalFlags

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

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.

Propriedades do parâmetro

Conjuntos de parâmetros

-LargeItemLimit

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

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

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 obter mais informações sobre valores máximos de tamanho de mensagem, consulte Limites de tamanho de mensagem no Exchange Server.

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 foi preterido no serviço baseado em nuvem. Em vez disso, a Pontuação de Consistência de Dados é usada e os administradores de locatários devem revisar o DataConsistencyScore e todos os itens ignorados após a conclusão da restauração.

Propriedades do parâmetro

Conjuntos de parâmetros

-MRSServer

Aplicável: 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.

Propriedades do parâmetro

Conjuntos de parâmetros

-Name

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

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 (em que X = 1-9).

Propriedades do parâmetro

Conjuntos de parâmetros

-Priority

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

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 (esse valor é o padrão).
• Alta
• Superior
• Mais Alta
• Emergência

Propriedades do parâmetro

Conjuntos de parâmetros

-RemoteCredential

Aplicável: Exchange Online

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

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

Propriedades do parâmetro

Conjuntos de parâmetros

-RemoteDatabaseGuid

Aplicável: Exchange Online

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

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

Propriedades do parâmetro

Conjuntos de parâmetros

-RemoteHostName

Aplicável: Exchange Online

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

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

Propriedades do parâmetro

Conjuntos de parâmetros

-RemoteRestoreType

Aplicável: Exchange Online

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

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

Propriedades do parâmetro

Conjuntos de parâmetros

-RequestExpiryInterval

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

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.

Propriedades do parâmetro

Conjuntos de parâmetros

-SkipMerging

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

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.

Propriedades do parâmetro

Conjuntos de parâmetros

-SourceDatabase

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

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

Propriedades do parâmetro

Conjuntos de parâmetros

-SourceEndpoint

Aplicável: Exchange Online

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

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

Propriedades do parâmetro

Conjuntos de parâmetros

-SourceExchangeGuid

Aplicável: Exchange Online

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

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

Propriedades do parâmetro

Conjuntos de parâmetros

-SourceIsArchive

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

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.

Propriedades do parâmetro

Conjuntos de parâmetros

-SourceMailbox

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

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 temporariamente é pelo seu valor GUID. Você pode encontrar o valor de GUID executando o seguinte comando: Get-Mailbox -SoftDeletedMailbox.

Propriedades do parâmetro

Conjuntos de parâmetros

-SourceRootFolder

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

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.

Propriedades do parâmetro

Conjuntos de parâmetros

-SourceStoreMailbox

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

Este parâmetro só é funcional 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.

Propriedades do parâmetro

Conjuntos de parâmetros

-SourceTenant

Aplicável: Exchange Online

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

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

Propriedades do parâmetro

Conjuntos de parâmetros

-Suspend

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

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

Se você usar essa opção, a solicitação será enfileirada, mas a solicitação não alcançará o status de InProgress até que você retome a solicitação com o cmdlet de currículo relevante.

Propriedades do parâmetro

Conjuntos de parâmetros

-SuspendComment

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

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.

Propriedades do parâmetro

Conjuntos de parâmetros

-TargetIsArchive

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

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

Propriedades do parâmetro

Conjuntos de parâmetros

-TargetMailbox

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

O parâmetro TargetMailbox especifica o GUID da caixa de correio de destino ou do usuário de email para o 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 o usuário de email executando os cmdlets Get-Mailbox ou Get-MailUser.

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

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

Propriedades do parâmetro

Conjuntos de parâmetros

-TargetRootFolder

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

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 principal para uma caixa de correio de arquivo morto, use este parâmetro para especificar as pastas da caixa de correio de arquivo morto 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 ficará visível porque está mapeado para locais na caixa de correio de arquivo morto que não são visíveis para os usuários.

Propriedades do parâmetro

Conjuntos de parâmetros

-TargetType

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

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ária (valor padrão)

Propriedades do parâmetro

Conjuntos de parâmetros

-WhatIf

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

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

Conjuntos de parâmetros

-WorkloadType

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

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

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

Propriedades do parâmetro

Conjuntos de parâmetros

CommonParameters

Entradas

Input types

Saídas

Output types