Get-MailboxImportRequest
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-MailboxImportRequest per visualizzare lo stato dettagliato di una richiesta di importazione in corso, avviata utilizzando il cmdlet New-MailboxImportRequest.
Questo cmdlet è disponibile solo nel ruolo Importazione esportazione cassette postali e, per impostazione predefinita, il ruolo non è assegnato ad alcun gruppo di ruoli. Per utilizzare il cmdlet, è necessario aggiungere il ruolo di importazione/esportazione delle cassette postali a un gruppo di ruoli (ad esempio, al gruppo di ruoli Gestione organizzazione). Per ulteriori informazioni, vedere Aggiungere un ruolo a un gruppo di ruoli.
Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.
Sintassi
Get-MailboxImportRequest
[[-Identity] <MailboxImportRequestIdParameter>]
[-DomainController <Fqdn>]
[-ResultSize <Unlimited>]
[<CommonParameters>] Get-MailboxImportRequest
[-BatchName <String>]
[-Database <DatabaseIdParameter>]
[-DomainController <Fqdn>]
[-HighPriority <Boolean>]
[-Mailbox <MailboxOrMailUserIdParameter>]
[-Name <String>]
[-ResultSize <Unlimited>]
[-Status <RequestStatus>]
[-Suspend <Boolean>]
[-RequestQueue <DatabaseIdParameter>]
[<CommonParameters>] Get-MailboxImportRequest
[-BatchName <String>]
[-Database <DatabaseIdParameter>]
[-DomainController <Fqdn>]
[-HighPriority <Boolean>]
[-Mailbox <MailboxLocationIdParameter>]
[-Name <String>]
[-ResultSize <Unlimited>]
[-Status <RequestStatus>]
[-Suspend <Boolean>]
[-RequestQueue <DatabaseIdParameter>]
[<CommonParameters>] Descrizione
I criteri di ricerca per Get-MailboxImportRequest sono costituiti da un'istruzione booleana And. Se si utilizzano più parametri, la ricerca viene circoscritta e il numero di risultati della ricerca è inferiore.
È 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-MailboxImportRequest -Identity "tony\Recovered"Con questo esempio vengono restituite le informazioni predefinite sullo stato della richiesta di importazione in corso con identità tony\Recovered. Le informazioni restituite per impostazione predefinita includono il nome, la cassetta postale e lo stato.
Esempio 2
Get-MailboxImportRequest -Status InProgress -Database DB01In Exchange Server 2010 questo esempio restituisce lo stato delle richieste di importazione in corso per cassette postali o archivi che risiedono nel database DB01.
Esempio 3
Get-MailboxImportRequest -BatchName "ImportingDB1PSTs" -Status CompletedCon questo esempio viene recuperato lo stato delle richieste di importazione completate nel batch ImportingDB1PSTs.
Esempio 4
Get-MailboxImportRequest -Name "Recovered" -Suspend $trueCon questo esempio vengono restituite tutte le richieste di importazione con nome Recovered per cui l'importazione è stata sospesa.
Parametri
-BatchName
Il parametro BatchName consente di specificare il nome assegnato alla richiesta di importazione in batch.
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 |
-Database
Questo parametro è disponibile solo in Exchange Server 2010.
Il parametro Database consente di specificare il database in cui risiede la cassetta postale o l'archivio dell'utente. È 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 |
-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
Questo parametro è disponibile solo in Exchange locale.
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 |
-Identity
Il parametro Identity consente di specificare l'identità della richiesta di importazione. Per impostazione predefinita, le richieste di importazione sono denominate <alias>\MailboxImportX (dove X = 0-9). Se si specifica un nome per la richiesta di importazione, usare la sintassi seguente: Alias\Name. Microsoft Exchange precede automaticamente la richiesta con l'alias della cassetta postale.
Non è possibile utilizzare questo parametro con i seguenti parametri.
- BatchName
- Cassetta postale
- Nome
- Stato
- Sospendere
- HighPriority
| Type: | MailboxImportRequestIdParameter |
| 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 |
-Mailbox
Questo parametro funziona solo in Exchange locale.
Il parametro Mailbox filtra i risultati in base alla cassetta postale di destinazione in cui viene importato il contenuto.
In Exchange 2016 CU7 o versioni successive questo parametro è il tipo MailboxLocationIdParameter, quindi il valore più semplice che è possibile usare per identificare la cassetta postale è il valore Alias.
In Exchange 2016 CU6 o versioni precedenti questo parametro è di tipo MailboxOrMailUserIdParameter, quindi è possibile usare qualsiasi valore che identifichi in modo univoco la cassetta postale. Ad esempio:
- Nome
- Alias
- Nome distinto (DN)
- Nome distinto (DN)
- Dominio\nomeutente
- Indirizzo di posta elettronica
- GUID
- LegacyExchangeDN
- SamAccountName
- ID utente o Nome entità utente (UPN)
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 |
-Name
Il parametro Name consente di specificare che devono essere restituite le richieste di importazione con il nome specificato.
Utilizzare questo parametro per eseguire una ricerca sul nome specificato durante la creazione della richiesta di importazione. Se non è stato specificato un nome in fase di creazione della richiesta, il nome predefinito è MailboxImportX (dove X = 0-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 |
-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.
CompletionInProgress e AutoSuspended non si applicano alle richieste di importazione e non restituiscono alcuna informazione.
| 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 |
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.