Condividi tramite


New-MailboxRestoreRequest

Questo cmdlet è disponibile in Exchange locale e nel servizio basato su cloud. Alcuni parametri e impostazioni possono essere esclusivi di singoli ambienti.

Utilizzare il cmdlet New-MailboxRestoreRequest per ripristinare una cassetta postale disconnessa o eliminata in maniera non definitiva. Il cmdlet avvia il processo di spostamento del contenuto dalla cassetta postale eliminata in maniera non definitiva, dalla cassetta postale disabilitata o da una cassetta postale che si trova in un database di ripristino in una cassetta postale principale connessa o di archiviazione.

Le proprietà usate per trovare le cassette postali disconnesse e ripristinare una cassetta postale sono diverse in Exchange Server e Exchange Online. Per altre informazioni su Exchange Online, vedere Ripristinare una cassetta postale inattiva.

Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.

Sintassi

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

Descrizione

Quando le cassette postali vengono spostate da un database a un altro, Exchange non elimina completamente la cassetta postale dal database di origine immediatamente dopo il completamento dello spostamento. La cassetta postale del database delle cassette postali di origine passa a uno stato di eliminazione non definitiva che consente l'accesso ai dati della cassetta postale durante l'operazione di ripristino della cassetta postale utilizzando la nuova impostazione del cmdlet MailboxRestoreRequest. Le cassette postali eliminate in maniera non definitiva vengono mantenute nel database di origine fino alla scadenza del periodo di conservazione della cassetta postale o fino a quando non si utilizza il cmdlet Remove-StoreMailbox per eliminare la cassetta postale.

Per visualizzare le cassette postali eliminate in maniera non definitiva, eseguire il cmdlet Get-MailboxStatistics su un database e controllare i risultati che hanno un DisconnectReason con un valore di SoftDeleted. Per ulteriori informazioni, vedere Esempio 1 più avanti in questo argomento.

Una cassetta postale viene contrassegnata come disabilitata poco dopo il completamento del comando Disable-Mailbox o Remove-Mailbox.

La cassetta postale non verrà contrassegnata come Disabilitata fino a quando il servizio Archivio informazioni di Microsoft Exchange non determina che Active Directory è stato aggiornato con le informazioni della cassetta postale disabilitata. Per rendere più rapido il processo, eseguire il cmdlet Update-StoreMailboxState su tale database.

Exchange conserva le cassette postali disabilitate nel database delle cassette postali in base alle impostazioni di conservazione delle cassette postali eliminate configurate per il database delle cassette postali. Dopo il periodo di tempo specificato, la cassetta postale verrà eliminata definitivamente.

Per visualizzare le cassette postali disabilitate, eseguire il cmdlet Get-MailboxStatistics su un database e controllare i risultati che hanno un DisconnectReason con un valore di Disabled. Per altre informazioni, vedere gli esempi 2 e 3 più avanti in questo argomento.

È necessario disporre delle autorizzazioni prima di poter eseguire questo cmdlet. Sebbene in questo argomento vengano elencati tutti i parametri relativi al cmdlet, si potrebbe non avere accesso ad alcuni di essi qualora non siano inclusi nelle autorizzazioni assegnate. Per individuare le autorizzazioni necessarie per eseguire cmdlet o parametri nell'organizzazione, vedere Trovare le autorizzazioni necessarie per eseguire i cmdlet di Exchange.

Nota: per ripristinare il contenuto di una cassetta postale primaria in una cassetta postale di archiviazione, usare il parametro TargetRootFolder per specificare le cartelle delle cassette postali di archiviazione in cui eseguire la migrazione del contenuto. Questo contenuto sarà visibile dopo il ripristino. Se non si usa questo parametro, il contenuto ripristinato non è visibile perché è mappato a percorsi nella cassetta postale di archiviazione non visibili agli utenti.

Esempio

Esempio 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

In Exchange locale questo esempio usa il cmdlet Get-MailboxStatistics per restituire DisplayName, LegacyExchangeDN e MailboxGUID (valori di identità delle cassette postali di origine validi) per tutte le cassette postali nel database delle cassette postali denominate MBD01 che hanno un motivo di disconnessione di SoftDeleted o Disabled.

Usando queste informazioni, la cassetta postale di origine con il valore MailboxGUID 1d20855f-fd54-4681-98e6-e249f7326ddd viene ripristinata nella cassetta postale di destinazione con il valore Alias Ayla.

Esempio 2

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

In Exchange locale questo esempio ripristina il contenuto della cassetta postale di origine con displayName di Tony Smith nel database delle cassette postali MBD01 nella cassetta postale di archiviazione per Tony@contoso.com.

Parametri

-AcceptLargeDataLoss

L'opzione AcceptLargeDataLoss consente di specificare che la richiesta deve proseguire anche se non è possibile copiare nella cassetta postale di destinazione un gran numero di elementi della cassetta postale di origine. Con questa opzione non è necessario specificare alcun valore.

In Exchange 2013 o versione successiva oppure in Exchange Online è necessario usare questa opzione se il parametro LargeItemLimit è impostato sul valore 51 o un valore superiore. In caso contrario, il comando avrà esito negativo.

In Exchange 2010 è necessario usare questa opzione se il parametro BadItemLimit è impostato sul valore 51 o un valore superiore. In caso contrario, il comando avrà esito negativo.

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

L'opzione AllowLegacyDNMismatch specifica che l'operazione deve continuare se LegacyExchangeDN della cassetta postale fisica di origine e la cassetta postale di destinazione non corrispondono. Con questa opzione non è necessario specificare alcun valore.

Per impostazione predefinita, il cmdlet esegue un controllo per assicurarsi che il LegacyExchangeDN della cassetta postale fisica di origine sia presente nell'utente di destinazione nel formato di LegacyExchangeDN o che un indirizzo proxy X500 corrisponda al LegacyExchangeDN. Questa verifica impedisce di ripristinare accidentalmente una cassetta postale di origine nella cassetta postale di destinazione errata.

Note: questo parametro verrà deprecato nel servizio basato su cloud. Per completare una richiesta di ripristino delle cassette postali con legacyExchangeDN che non corrisponde, è necessario ottenere il valore LegacyExchangeDN per la cassetta postale di origine e aggiungerlo alla cassetta postale di destinazione come indirizzo proxy X500. Per istruzioni dettagliate, vedere Ripristinare una cassetta postale inattiva.

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

Il parametro AssociatedMessagesCopyOption consente di specificare se i messaggi associati vengono copiati durante l'elaborazione della richiesta. I messaggi associati sono messaggi speciali che contengono dati nascosti con informazioni sulle regole, sulle visualizzazioni e sui moduli. I valori validi sono:

  • DoNotCopy: i messaggi associati non vengono copiati.
  • MapByMessageClass: trovare il messaggio associato cercando l'attributo MessageClass del messaggio di origine. Se è presente un messaggio associato di questa classe in entrambe le cartelle di origine e destinazione, il messaggio associato nella destinazione viene sovrascritto. Se nella destinazione non è presente un messaggio associato, viene creata una copia nella destinazione.
  • Copia: copiare i messaggi associati dall'origine alla destinazione. Se nei percorsi di origine e destinazione esiste lo stesso tipo di messaggio, questi messaggi associati vengono duplicati. Questo è il valore predefinito.

Il filtro contenuto non viene applicato ai messaggi associati.

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

Il parametro BadItemLimit consente di specificare il numero massimo di elementi non validi consentiti prima che la richiesta abbia un esito negativo. Un elemento non valido è un elemento danneggiato nella cassetta postale di origine che non è possibile copiare nella cassetta postale di destinazione. Rientrano negli elementi non validi anche gli elementi mancanti. Gli elementi mancanti sono elementi nella cassetta postale di origine che non è possibile rilevare nella cassetta postale di destinazione quando la richiesta è pronta per essere completata.

L'input valido per questo parametro è un numero intero o il valore Unlimited. Il valore predefinito è 0, che indica che la richiesta avrà esito negativo se vengono rilevati elementi non validi. Se si decide di lasciare alcuni elementi non validi, è possibile impostare questo parametro su un valore ragionevole (si consiglia 10 o un valore inferiore) in modo da consentire l'elaborazione della richiesta. In caso di rilevamento di un numero eccessivo di elementi non validi, provare a utilizzare il cmdlet New-MailboxRepairRequest per tentare di correggere gli elementi corrotti nella cassetta postale di origine e procedere di nuovo con la richiesta.

Se in Exchange 2010 si imposta il valore su 51 o su un valore maggiore, è necessario utilizzare anche l'opzione AcceptLargeDataLoss. In caso contrario, il comando avrà esito negativo.

Note: questo parametro verrà deprecato nel servizio basato su cloud. In futuro, se non si usa questo parametro, verrà usata la semantica di approvazione di elementi ignorati.

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

Il parametro BatchName consente di specificare un nome descrittivo per il ripristino di un gruppo di cassette postali. È quindi possibile utilizzare il nome nel parametro BatchName come una stringa di ricerca quando si utilizza il 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

Il parametro CompletedRequestAgeLimit consente di specificare per quanto tempo lo stato di una richiesta di ripristino completata è impostato su Completed. Se il parametro è impostato sul valore 0, lo stato non viene modificato in Completed, ma viene cancellato immediatamente.

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

L'opzione Confirm consente di specificare se visualizzare o nascondere la richiesta di conferma. L'impatto di questa opzione sul cmdlet dipende dalla richiesta di conferma del cmdlet prima di procedere.

  • I cmdlet distruttivi , ad esempio i cmdlet Remove-*, hanno una pausa predefinita che impone di confermare il comando prima di procedere. Per questi cmdlet, è possibile ignorare la richiesta di conferma usando questa precisa sintassi: -Confirm:$false.
  • La maggior parte degli altri cmdlet (ad esempio, i cmdlet New-* e Set-*) non hanno una pausa predefinita. Per questi cmdlet, specificando l'opzione Confirm senza un valore viene introdotta una pausa che impone all'utente di confermare il comando prima di procedere.
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

Il parametro ConflictResolutionOption consente di specificare le operazioni da eseguire se sono presenti più messaggi corrispondenti nella destinazione. I valori validi sono:

  • 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

Questo parametro è disponibile solamente nel servizio basato su cloud.

Il parametro ContentFilter usa la sintassi del filtro OPATH per filtrare i risultati in base alle proprietà e ai valori specificati. Verrà ripristinato solo il contenuto che corrisponde al parametro ContentFilter. I criteri di ricerca usano la sintassi "Property -ComparisonOperator 'Value'".

  • Racchiudere l'intero filtro OPATH tra virgolette doppie " ". Se il filtro contiene valori di sistema (ad esempio, $true, $falseo $null), usare le virgolette singole ''. Sebbene questo parametro sia una stringa (non un blocco di sistema), è anche possibile usare le parentesi graffe { }, ma solo se il filtro non contiene variabili.
  • La proprietà è una proprietà filtrabile. Per le proprietà filtrabili, vedere Proprietà filtrabili per il parametro ContentFilter.
  • ComparisonOperator è un operatore di confronto OPATH, ad esempio -eq per equals e -like per il confronto di stringhe. Per ulteriori informazioni sugli operatori di confronto, vedere about_Comparison_Operators.
  • Il valore è il valore della proprietà da cercare. Racchiudere valori di testo e variabili tra virgolette singole ('Value' o '$Variable'). Se un valore variabile contiene virgolette singole, è necessario identificare (escape) le virgolette singole per espandere correttamente la variabile. Ad esempio, invece di '$User', usare '$($User -Replace "'","''")'. Non racchiudere valori interi o di sistema tra virgolette, ad esempio usare 500, $true, $falseo $null .

È possibile concatenare più criteri di ricerca usando gli operatori -and logici e -or. Ad esempio, "Criteria1 -and Criteria2" o "(Criteria1 -and Criteria2) -or Criteria3".

Per informazioni dettagliate sui filtri OPATH in Exchange, vedere Informazioni aggiuntive sulla sintassi OPATH.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-ContentFilterLanguage

Questo parametro è disponibile solamente nel servizio basato su cloud.

Il parametro ContentFilterLanguage consente di specificare la lingua utilizzata nel parametro ContentFilter per eseguire le ricerche di stringhe.

L'input valido per questo parametro è un valore di codice delle impostazioni cultura supportato dalla classe CultureInfo di Microsoft .NET Framework. Ad esempio, da-DK per il danese o ja-JP per il giapponese. Per altre informazioni, vedere Classe CultureInfo.

Type:CultureInfo
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-CrossTenantRestore

Questo parametro è disponibile solamente nel servizio basato su cloud.

Questo parametro è riservato all'uso interno da parte di Microsoft.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-DomainController

Questo parametro funziona solo in Exchange locale.

Il parametro DomainController consente di specificare il controller di dominio utilizzato da questo cmdlet per la lettura o la scrittura dei dati in Active Directory. Identificare il controller di dominio mediante il relativo nome di dominio completo (FQDN). Ad esempio, 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

L'opzione ExcludeDumpster specifica se escludere la cartella Elementi ripristinabili. Con questa opzione non è necessario specificare alcun valore.

Se non si usa questa opzione, la cartella Elementi ripristinabili viene copiata con le sottocartelle seguenti:

  • Eliminazioni
  • Versioni
  • Purges
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

Il parametro ExcludeFolders consente di specificare l'elenco delle cartelle da escludere durante la richiesta di ripristino.

I nomi delle cartelle non fanno distinzione tra maiuscole e minuscole e non sono previste limitazioni sui caratteri. Usare la seguente sintassi:

<FolderName>/*: utilizzare questa sintassi per indicare una cartella personale nella cartella specificata nel parametro SourceRootFolder, ad esempio "MyProjects" o "MyProjects/FY2010".

#<FolderName>#/*: utilizzare questa sintassi per indicare una cartella nota indipendentemente dal nome della cartella in un'altra lingua. Ad esempio, #Inbox# indica la cartella Inbox, anche se questa viene localizzata in italiano (Posta in arrivo). Le cartelle note includono i seguenti tipi:

  • Posta in arrivo
  • SentItems
  • DeletedItems
  • Calendario
  • Contatti
  • Bozze
  • Diario
  • Attività
  • Note
  • JunkEmail
  • CommunicatorHistory
  • Messaggi vocali
  • Fax
  • Conflitti
  • SyncIssues
  • LocalFailures
  • ServerFailures

Se l'utente crea una cartella personale con lo stesso nome di una cartella nota e il simbolo # che la circonda, è possibile usare una barra rovesciata (\) come carattere di escape per specificare tale cartella. Ad esempio, se un utente crea una cartella denominata #Notes# e si desidera specificare tale cartella anziché la cartella Note nota, usare la sintassi seguente: \#Notes\#.

Non è possibile usare i caratteri jolly nei nomi delle cartelle.

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

Il parametro IncludeFolders consente di specificare l'elenco delle cartelle da includere durante la richiesta di ripristino.

I nomi delle cartelle non fanno distinzione tra maiuscole e minuscole e non sono previste limitazioni sui caratteri. Usare la seguente sintassi:

<FolderName>/*: utilizzare questa sintassi per indicare una cartella personale nella cartella specificata nel parametro SourceRootFolder, ad esempio "MyProjects" o "MyProjects/FY2010".

#<FolderName>#/*: utilizzare questa sintassi per indicare una cartella nota indipendentemente dal nome della cartella in un'altra lingua. Ad esempio, #Inbox# indica la cartella Inbox, anche se questa viene localizzata in italiano (Posta in arrivo). Le cartelle note includono i seguenti tipi:

  • Posta in arrivo
  • SentItems
  • DeletedItems
  • Calendario
  • Contatti
  • Bozze
  • Diario
  • Attività
  • Note
  • JunkEmail
  • CommunicationHistory
  • Messaggi vocali
  • Fax
  • Conflitti
  • SyncIssues
  • LocalFailures
  • ServerFailures

Se l'utente crea una cartella personale con lo stesso nome di una cartella nota e il simbolo # che la circonda, è possibile usare una barra rovesciata (\) come carattere di escape per specificare tale cartella. Ad esempio, se un utente crea una cartella denominata #Notes# e si desidera specificare tale cartella anziché la cartella Note nota, usare la sintassi seguente: \#Notes\#.

Non è possibile usare i caratteri jolly nei nomi delle cartelle.

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

Questo parametro è disponibile solo in Exchange locale.

Il parametro InternalFlags indica i passaggi facoltativi della richiesta. Questo parametro è utilizzato principalmente a fini di debug.

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

Il parametro LargeItemLimit consente di specificare il numero massimo di elementi di grandi dimensioni consentiti prima che la richiesta abbia un esito negativo. Un elemento di grandi dimensioni è un messaggio nella cassetta postale di origine che supera la dimensione massima dei messaggi consentita nella cassetta postale di destinazione. Se la cassetta postale di destinazione non dispone di un valore di dimensione massima dei messaggi configurato in modo specifico, viene utilizzato il valore al livello dell'organizzazione.

Per ulteriori informazioni sui valori della dimensione massima dei messaggi, vedere i seguenti argomenti:

L'input valido per questo parametro è un numero intero o il valore Unlimited. Il valore predefinito è 0, che indica che la richiesta avrà esito negativo se vengono rilevati elementi di grandi dimensioni. Se si decide di lasciare alcuni elementi di grandi dimensioni, è possibile impostare questo parametro su un valore ragionevole (si consiglia 10 o un valore inferiore) in modo da consentire l'elaborazione della richiesta.

Se si imposta il valore su 51 o su un valore maggiore, è necessario utilizzare anche l'opzione AcceptLargeDataLoss. In caso contrario, il comando avrà esito negativo.

Note: questo parametro verrà deprecato nel servizio basato su cloud. In futuro, se non si usa questo parametro, verrà usata la semantica di approvazione di elementi ignorati.

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

Questo parametro è disponibile solo in Exchange Server 2010.

Il parametro MRSServer consente di specificare il nome di dominio completo (FQDN) del server Accesso client su cui è in esecuzione l'istanza del servizio di replica delle cassette postali di Microsoft Exchange. Questo parametro viene utilizzato solo per il debug. Utilizzare questo parametro solo se indicato dal personale del supporto.

Type:Fqdn
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-Name

Il parametro Name consente di specificare il nome della richiesta specifica per ragioni di verifica e di visualizzazione. Poiché è possibile avere più richieste di ripristino per cassetta postale, Exchange precede il nome con l'alias della cassetta postale. Ad esempio, se si crea una richiesta di esportazione per la cassetta postale di un utente che contiene l'alias Kweku e si specifica il valore del parametro come RestoreFailedMoves, l'identità della richiesta di esportazione sarà Kweku\RestoreFailedMoves.

Se non è stato specificato un nome per la richiesta di ripristino al momento della creazione, Exchange genera automaticamente il nome predefinito MailboxRestore. Exchange genera fino a 10 nomi, a partire da MailboxRestore e quindi MailboxRestoreX (dove 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

Questo parametro è disponibile solo in Exchange locale.

Il parametro Priority consente di specificare l'ordine di elaborazione della richiesta nella coda delle richieste. Le richieste vengono elaborate con un ordine basato sull'integrità, lo stato, la priorità e l'ora di ultimo aggiornamento del server. I valori di priorità validi sono:

  • Lowest
  • Lower
  • Low
  • Normale (valore predefinito).
  • High
  • Higher
  • Highest
  • Emergency
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

Questo parametro è disponibile solamente nel servizio basato su cloud.

Questo parametro è riservato all'uso interno da parte di Microsoft.

Type:PSCredential
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-RemoteDatabaseGuid

Questo parametro è disponibile solamente nel servizio basato su cloud.

Questo parametro è riservato all'uso interno da parte di Microsoft.

Type:Guid
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-RemoteHostName

Questo parametro è disponibile solamente nel servizio basato su cloud.

Questo parametro è riservato all'uso interno da parte di Microsoft.

Type:Fqdn
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-RemoteRestoreType

Questo parametro è disponibile solamente nel servizio basato su cloud.

Questo parametro è riservato all'uso interno da parte di Microsoft.

Type:RemoteRestoreType
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-RequestExpiryInterval

Questo parametro è disponibile solo in Exchange locale.

Il parametro RequestExpiryInterval consente di specificare un periodo di validità per una richiesta completata o non riuscita. Quando si utilizza questo parametro, la richiesta completata o non riuscita viene rimossa automaticamente dopo la scadenza dell'intervallo specificato. Se non si utilizza questo parametro:

  • La richiesta completata viene rimossa automaticamente in base al valore del parametro CompletedRequestAgeLimit.
  • Se la richiesta ha esito negativo, è necessario rimuoverla manualmente usando il cmdlet Remove-*Request corrispondente.

Per specificare un valore, immetterlo come intervallo di tempo: dd.hh:mm:ss dove dd = giorni, hh = ore, mm = minuti e ss = secondi.

Quando si utilizza il valore Unlimited, la richiesta completata non viene rimossa 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

Il parametro SkipMerging consente di specificare gli elementi correlati alla cartella che devono essere ignorati durante il ripristino della cassetta postale. Utilizzare uno dei seguenti valori:

  • FolderACLs
  • FolderProperties
  • FolderRules
  • InitialConnectionValidation

Utilizzare il parametro solo se una richiesta di ripristino ha esito negativo a causa delle regole della cartella, degli elenchi di controllo di accesso alla cartella (ACL) o della convalida iniziale della connessione.

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

Questo parametro è disponibile solo in Exchange locale.

Il parametro SourceDatabase consente di specificare l'identità del database da cui viene eseguito il ripristino della cassetta postale con eliminazione reversibile o disconnessa. È possibile utilizzare qualsiasi valore che identifichi il database in maniera univoca. Ad esempio:

  • Nome
  • Nome distinto (DN)
  • 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

Questo parametro è disponibile solamente nel servizio basato su cloud.

Questo parametro è riservato all'uso interno da parte di Microsoft.

Type:MigrationEndpointIdParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-SourceExchangeGuid

Questo parametro è disponibile solamente nel servizio basato su cloud.

Questo parametro è riservato all'uso interno da parte di Microsoft.

Type:Guid
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-SourceIsArchive

L'opzione SourceIsArchive consente di specificare che la cassetta postale di origine è una cassetta postale di archiviazione. Con questa opzione non è necessario specificare alcun valore.

È possibile utilizzare questa opzione soltanto con il parametro 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

Il parametro SourceMailbox consente di specificare la cassetta postale con eliminazione reversibile da ripristinare. Il modo migliore per identificare la cassetta postale eliminata temporaneamente è il relativo valore GUID. È possibile trovare questo valore utilizzando il seguente 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

Il parametro SourceRootFolder consente di specificare la cartella radice della cassetta postale da cui vengono ripristinati i dati. Se questo parametro non viene specificato, il comando ripristina tutte le cartelle.

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

Questo parametro funziona solo in Exchange locale.

Il parametro SourceStoreMailbox consente di specificare il valore MailboxGUID della cassetta postale di origine da cui si vuole ripristinare il contenuto.

È possibile trovare MailboxGUID eseguendo il 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

Questo parametro è disponibile solamente nel servizio basato su cloud.

Questo parametro è riservato all'uso interno da parte di Microsoft.

Type:SmtpDomain
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-Suspend

L'opzione Suspend consente di specificare se sospendere o meno la richiesta. Con questa opzione non è necessario specificare alcun valore.

Se si utilizza questa opzione, la richiesta viene accodata e non raggiunge lo stato InProgress fino a quando non viene ripresa tramite l'apposito cmdlet.

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

Il parametro SuspendComment consente di specificare la descrizione del motivo per cui la richiesta è stata sospesa. È possibile utilizzare questo parametro solo se si specifica il parametro Suspend.

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

L'opzione TargetIsArchive specifica che il contenuto viene ripristinato nell'archivio della cassetta postale di destinazione specificata. Con questa opzione non è necessario specificare alcun valore.

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

Il parametro TargetMailbox consente di specificare il GUID della cassetta postale di destinazione o dell'utente di posta in cui si vuole ripristinare il contenuto. Per eseguire correttamente il comando, è necessario che siano presenti la cassetta postale di destinazione o l'utente di posta.

È possibile trovare il valore GUID per la cassetta postale o l'utente di posta elettronica eseguendo i cmdlet Get-Mailbox o Get-MailUser.

In Exchange 2016 o versioni successive e Exchange Online, questo parametro è il tipo MailboxLocationIdParameter.

In Exchange 2013 o versioni precedenti questo parametro è di 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

Il parametro TargetRootFolder consente di specificare la cartella principale in cui ripristinare i dati. Se il parametro non viene specificato, il comando ripristina le cartelle nella struttura della cartella principale nell'archivio o nella cassetta postale di destinazione. Il contenuto viene unito nelle cartelle esistenti e vengono create nuove cartelle se non sono già esistenti nella struttura della cartella di destinazione.

Nota: per ripristinare il contenuto di una cassetta postale primaria in una cassetta postale di archiviazione, usare questo parametro per specificare le cartelle della cassetta postale di archiviazione in cui eseguire la migrazione del contenuto. Questo contenuto sarà visibile dopo il ripristino. Se non si usa questo parametro, il contenuto ripristinato non è visibile perché è mappato a percorsi nella cassetta postale di archiviazione non visibili agli utenti.

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

Il parametro TargetType consente di specificare il tipo di cassetta postale di destinazione per l'operazione di ripristino. I valori validi sono:

  • Archiviare
  • MailboxLocation
  • Primario (questo è il valore predefinito)
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

L'opzione WhatIf consente di simulare le azioni del comando. È possibile utilizzare tale opzione per visualizzare le modifiche che verrebbero applicate senza effettivamente applicarle. Con questa opzione non è necessario specificare alcun valore.

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

Questo parametro è disponibile solo in Exchange locale.

Questo parametro è riservato all'uso interno da parte di 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

Input

Input types

Per verificare i tipi di input accettati da questo cmdlet, vedere Tipi di input e output dei cmdlet. Se il campo relativo al tipo di input di un cmdlet è vuoto, il cmdlet non accetta dati di input.

Output

Output types

Per verificare i tipi restituiti, detti anche tipi di output, accettati da questo cmdlet, vedere Tipi di input e output dei cmdlet. Se il campo relativo al tipo di output è vuoto, il cmdlet non restituisce dati.