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 MBD01

In 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 MBD01

Con 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 $true

In 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.