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 AylaIn 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 -TargetIsArchiveIn 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
-eqper equals e-likeper 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 usare500,$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:
- Exchange 2016: limiti delle dimensioni dei messaggi in Exchange Server
- Exchange Online: Limiti di Exchange Online
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.