Get-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 Get-MailboxRestoreRequest per visualizzare lo stato dettagliato di una richiesta di ripristino in corso avviata utilizzando il cmdlet New-MailboxRestoreRequest.
Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.
Sintassi
Get-MailboxRestoreRequest
[[-Identity] <MailboxRestoreRequestIdParameter>]
[-DomainController <Fqdn>]
[-ResultSize <Unlimited>]
[<CommonParameters>] Get-MailboxRestoreRequest
[-BatchName <String>]
[-HighPriority <Boolean>]
[-Name <String>]
[-RequestQueue <DatabaseIdParameter>]
[-SourceDatabase <DatabaseIdParameter>]
[-Status <RequestStatus>]
[-Suspend <Boolean>]
[-TargetDatabase <DatabaseIdParameter>]
[-TargetMailbox <MailboxOrMailUserIdParameter>]
[-DomainController <Fqdn>]
[-ResultSize <Unlimited>]
[<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
Get-MailboxRestoreRequest -Identity "Ayla\MailboxRestore"Questo esempio restituisce lo stato della richiesta di ripristino in corso e in coda con l'identità ayla\MailboxRestore, dove Ayla è il nome dell'utente.
Esempio 2
Get-MailboxRestoreRequest -TargetDatabase MBD01In Exchange Server 2010 questo esempio restituisce lo stato delle richieste di ripristino in corso e in coda che vengono ripristinate nel database di destinazione MBD01.
Esempio 3
Get-MailboxRestoreRequest -RequestQueue MBD01Con questo esempio viene restituito lo stato delle richieste di ripristino in corso o in coda in fase di ripristino nel database di cassette postali MBD01.
Esempio 4
Get-MailboxRestoreRequest -Name "RestoreToMBD01" -Suspend $trueIn questo esempio vengono restituite tutte le richieste di ripristino con il nome RestoreToMBD01 in cui la richiesta di ripristino è stata sospesa.
Parametri
-BatchName
Il parametro BatchName consente di specificare il nome assegnato a un gruppo di richieste di ripristino.
Non è possibile utilizzare questo parametro con il parametro Identity.
| 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 |
-DomainController
Questo parametro è disponibile 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 |
-HighPriority
Il parametro HighPriority consente di filtrare i risultati in base al valore Priority assegnato al momento della creazione della richiesta. L'input valido per questo parametro è $true o $false. Ecco come questi valori filtrano i risultati:
- $true Restituisce le richieste create con il valore priority High, Higher, Highest o Emergency.
- $false Restituisce le richieste create con il valore Priority Normal, Low, Lower o Lowest.
Non è possibile utilizzare questo parametro con il parametro Identity.
| Type: | Boolean |
| 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).
Non è possibile utilizzare questo parametro con il parametro Name.
| Type: | MailboxRestoreRequestIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Name
Il parametro Name consente di specificare che verranno restituite tutte le richieste di ripristino con il nome indicato.
Utilizzare il parametro per cercare il nome fornito al momento della creazione della richiesta di ripristino.
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).
Non è possibile utilizzare questo parametro con il parametro Identity.
| 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 |
-RequestQueue
Questo parametro è disponibile solo in Exchange locale.
Il parametro RequestQueue consente di identificare la richiesta basata sul database delle cassette postali in cui è in esecuzione la richiesta. È possibile utilizzare qualsiasi valore che identifichi il database in maniera univoca. Ad esempio:
- Nome
- Nome distinto (DN)
- GUID
Non è possibile utilizzare questo parametro con il parametro Identity.
| Type: | DatabaseIdParameter |
| 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 |
-ResultSize
Il parametro ResultSize consente di specificare il numero massimo di risultati da restituire. Se si desidera restituire tutte le richieste che soddisfano la query, impostare questo parametro sul valore unlimited. Il valore predefinito è 1000.
| 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 |
-SourceDatabase
Questo parametro è disponibile solo in Exchange locale.
Il parametro SourceDatabase consente di specificare che il cmdlet deve restituire solo le richieste per le cassette postali ripristinate dal database di origine indicato. È possibile utilizzare qualsiasi valore che identifichi il database in maniera univoca. Ad esempio:
- Nome
- Nome distinto (DN)
- GUID
Non è possibile utilizzare questo parametro con il parametro Identity.
| Type: | DatabaseIdParameter |
| 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 |
-Status
Il parametro Status consente di filtrare i risultati in base allo stato. È possibile utilizzare i seguenti valori:
- AutoSuspended
- Completata
- CompletedWithWarning
- CompletionInProgress
- Esito negativo
- Inprogress
- In coda
- Riprovare
- Sospeso
- Sincronizzati
Non è possibile utilizzare questo parametro con il parametro Identity.
| Type: | RequestStatus |
| 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 |
-Suspend
Il parametro Suspend consente di specificare se restituire le richieste che sono state sospese. L'input valido per questo parametro è $true o $false.
Non è possibile utilizzare questo parametro con il parametro Identity.
| Type: | Boolean |
| 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 |
-TargetDatabase
Questo parametro è disponibile solo in Exchange Server 2010.
Il parametro TargetDatabase specifica che il cmdlet deve restituire solo le richieste di ripristino per le cassette postali che risiedono nel database di destinazione. È possibile utilizzare qualsiasi valore che identifichi il database in maniera univoca. Ad esempio:
- Nome
- Nome distinto (DN)
- GUID
Non è possibile utilizzare questo parametro con il parametro Identity.
| Type: | DatabaseIdParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010 |
-TargetMailbox
Il parametro TargetMailbox consente di specificare l'identità della cassetta postale di destinazione. È possibile utilizzare i seguenti valori:
- GUID
- Nome distinto (DN)
- Dominio\Account
- Nome dell'entità utente (UPN)
- DN legacy di Exchange
- Indirizzo SMTP
- Alias
Non è possibile utilizzare questo parametro con il parametro Identity.
| Type: | MailboxOrMailUserIdParameter |
| 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 |
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.