Get-MailboxImportRequest

Modulo:

ExchangePowerShell

Si applica a:

Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

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

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