Set-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 Set-MailboxRestoreRequest per modificare le opzioni della richiesta di ripristino dopo la relativa creazione. È possibile utilizzare questo cmdlet per risolvere le richieste di ripristino non riuscite.
Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.
Sintassi
Set-MailboxRestoreRequest
[-Identity] <MailboxRestoreRequestIdParameter>
[-AcceptLargeDataLoss]
[-BadItemLimit <Unlimited>]
[-BatchName <String>]
[-CompletedRequestAgeLimit <Unlimited>]
[-Confirm]
[-DomainController <Fqdn>]
[-InternalFlags <InternalMrsFlag[]>]
[-LargeItemLimit <Unlimited>]
[-Priority <RequestPriority>]
[-RemoteHostName <Fqdn>]
[-RequestExpiryInterval <Unlimited>]
[-SkipInitialConnectionValidation]
[-SkipMerging <SkippableMergeComponent[]>]
[-SkippedItemApprovalTime <DateTime>]
[-SourceWlmLevel <WlmLevel>]
[-TargetWlmLevel <WlmLevel>]
[-WhatIf]
[<CommonParameters>]
Set-MailboxRestoreRequest
[-Identity] <MailboxRestoreRequestIdParameter>
[-Confirm]
[-DomainController <Fqdn>]
[-RehomeRequest]
[-RemoteHostName <Fqdn>]
[-RequestExpiryInterval <Unlimited>]
[-SkipInitialConnectionValidation]
[-SkippedItemApprovalTime <DateTime>]
[-SourceWlmLevel <WlmLevel>]
[-TargetWlmLevel <WlmLevel>]
[-WhatIf]
[<CommonParameters>]
Descrizione
È 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.
Esempio
Esempio 1
Set-MailboxRestoreRequest -Identity "Ayla\MailboxRestore1" -BadItemLimit 10
In questo esempio viene modificata la seconda richiesta di ripristino per Ayla\MailboxRestore1 per ignorare 10 elementi danneggiati di cassette postali.
Esempio 2
Set-MailboxRestoreRequest -Identity "Kweku\MailboxRestore" -BadItemLimit 100 -AcceptLargeDataLoss
In questo esempio viene modificata la prima richiesta di ripristino per la cassetta postale di Kweku per ignorare 100 elementi danneggiati di cassette postali. Poiché il valore di BadItemLimit è maggiore di 50, è necessario specificare il parametro AcceptLargeDataLoss.
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 |
-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 il nome del batch. Utilizzare questo parametro per modificare, creare o rimuovere il nome di un batch.
Per rimuovere il nome di un batch, impostare il valore del parametro BatchName su una stringa vuota o su Null, ad esempio, -BatchName "" o -BatchName $null.
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 questo parametro è impostato su un valore pari a 0, lo stato viene immediatamente cancellato invece di essere modificato su Completed.
Type: | Unlimited |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Confirm
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, Exchange Online Protection |
-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 |
-Identity
Il parametro Identity consente di specificare l'identità della richiesta di ripristino. Il parametro Identity è composto dall'alias della cassetta postale da ripristinare e dal nome specificato al momento della creazione della richiesta di ripristino. L'identità della richiesta di ripristino usa la sintassi seguente: Alias\Name
Se non è stato specificato un nome per la richiesta di ripristino al momento della creazione, Exchange ha generato automaticamente il nome predefinito MailboxRestore. Exchange genera fino a 10 nomi, a partire da MailboxRestore e quindi MailboxRestoreX (dove X = 1-9).
Type: | MailboxRestoreRequestIdParameter |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-InternalFlags
Questo parametro funziona 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, Exchange Online |
-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 |
-Priority
Questo parametro funziona 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
- Normal: questo è il 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, Exchange Online |
-RehomeRequest
Questo parametro funziona solo in Exchange locale.
L'opzione RehomeRequest sposta la richiesta di ripristino della cassetta postale in un database di cassette postali diverso. Con questa opzione non è necessario specificare alcun valore.
Usare questa opzione per modificare una richiesta di ripristino della cassetta postale nel caso in cui il database della cassetta postale di origine dalla richiesta di spostamento originale debba essere rimosso.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-RemoteHostName
Questo parametro è riservato all'uso interno da parte di Microsoft.
Type: | Fqdn |
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 |
-RequestExpiryInterval
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 = days, hh = hours, 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, Exchange Online |
-SkipInitialConnectionValidation
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: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-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 |
-SkippedItemApprovalTime
Questo parametro è disponibile solamente nel servizio basato su cloud.
Questo parametro è riservato all'uso interno da parte di Microsoft.
Type: | DateTime |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-SourceWlmLevel
Questo parametro è disponibile solamente nel servizio basato su cloud.
{{ Fill SourceWlmLevel Description }}
Type: | WlmLevel |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-TargetWlmLevel
Questo parametro è disponibile solamente nel servizio basato su cloud.
{{ Fill TargetWlmLevel Description }}
Type: | WlmLevel |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | 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, Exchange Online Protection |
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.