Get-MailboxImportRequest
Questo cmdlet è disponibile in Exchange locale e nel servizio basato su cloud. Alcuni parametri e impostazioni potrebbero essere esclusivi per un ambiente o l'altro.
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
Identity
Get-MailboxImportRequest
[[-Identity] <MailboxImportRequestIdParameter>]
[-DomainController <Fqdn>]
[-ResultSize <Unlimited>]
[<CommonParameters>]
Filtering
Get-MailboxImportRequest
[-Mailbox <MailboxLocationIdParameter>]
[-BatchName <String>]
[-Database <DatabaseIdParameter>]
[-DomainController <Fqdn>]
[-HighPriority <Boolean>]
[-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. Anche se questo articolo elenca tutti i parametri per il cmdlet, è possibile che non si abbia accesso ad alcuni parametri se non sono inclusi nelle autorizzazioni assegnate all'utente. 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 DB01
In 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 Completed
Con questo esempio viene recuperato lo stato delle richieste di importazione completate nel batch ImportingDB1PSTs.
Esempio 4
Get-MailboxImportRequest -Name "Recovered" -Suspend $true
In questo esempio vengono restituite tutte le richieste di importazione con il nome Recovered in cui l'importazione viene sospesa.
Parametri
-BatchName
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
Il parametro BatchName consente di specificare il nome assegnato alla richiesta di importazione in batch.
Non è possibile utilizzare questo parametro con il parametro Identity.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
MailboxFiltering
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
MailboxLocationFiltering
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Database
Applicabile: Exchange Server 2010
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.
Proprietà dei parametri
| Tipo: | DatabaseIdParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
MailboxFiltering
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
MailboxLocationFiltering
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-DomainController
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
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.
Proprietà dei parametri
| Tipo: | Fqdn |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-HighPriority
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
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.
Proprietà dei parametri
| Tipo: | Boolean |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
MailboxFiltering
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
MailboxLocationFiltering
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Identity
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
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
Attenzione: il valore $null o un valore inesistente per il parametro Identity restituisce tutti gli oggetti come se fosse stato eseguito il comando Get- senza il parametro Identity. Verificare che gli elenchi di valori per il parametro Identity siano accurati e non contengano valori $null inesistenti.
Proprietà dei parametri
| Tipo: | MailboxImportRequestIdParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
Identity
| Posizione: | 1 |
| Obbligatorio: | False |
| Valore dalla pipeline: | True |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
-Mailbox
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
Questo parametro è funzionale 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 il tipo di parametro è MailboxLocationIdParameter. Il valore Alias è il modo più semplice per identificare la cassetta postale.
Non è possibile utilizzare questo parametro con il parametro Identity.
Suggerimento: in Exchange 2016 CU6 o versioni precedenti il tipo di parametro era MailboxOrMailUserIdParameter. È possibile usare qualsiasi valore che abbia identificato in modo univoco la cassetta postale (incluso Alias).
Proprietà dei parametri
| Tipo: | MailboxLocationIdParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
MailboxLocationFiltering
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Name
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
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.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
MailboxFiltering
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
MailboxLocationFiltering
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-RequestQueue
Applicabile: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
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.
Proprietà dei parametri
| Tipo: | DatabaseIdParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
MailboxFiltering
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
MailboxLocationFiltering
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-ResultSize
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
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.
Proprietà dei parametri
| Tipo: | Unlimited |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Status
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
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.
Proprietà dei parametri
| Tipo: | RequestStatus |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
MailboxFiltering
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
MailboxLocationFiltering
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Suspend
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
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.
Proprietà dei parametri
| Tipo: | Boolean |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
MailboxFiltering
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
MailboxLocationFiltering
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
CommonParameters
Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedere about_CommonParameters.
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.