Get-MoveRequest

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-MoveRequest per visualizzare lo stato dettagliato di uno spostamento asincrono in corso della cassetta postale avviato utilizzando il cmdlet New-MoveRequest.

Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.

Sintassi

Get-MoveRequest
   [[-Identity] <MoveRequestIdParameter>]
   [-Credential <PSCredential>]
   [-DomainController <Fqdn>]
   [-OrganizationalUnit <OrganizationalUnitIdParameter>]
   [-ResultSize <Unlimited>]
   [-SortBy <String>]
   [-IncludeSoftDeletedObjects]
   [-ProxyToMailbox <MailboxIdParameter>]
   [<CommonParameters>]

Get-MoveRequest
   [-BatchName <String>]
   [-Credential <PSCredential>]
   [-DomainController <Fqdn>]
   [-Flags <RequestFlags>]
   [-HighPriority <Boolean>]
   [-IncludeSoftDeletedObjects]
   [-MoveStatus <RequestStatus>]
   [-Offline <Boolean>]
   [-OrganizationalUnit <OrganizationalUnitIdParameter>]
   [-Protect <Boolean>]
   [-ProxyToMailbox <MailboxIdParameter>]
   [-RemoteHostName <Fqdn>]
   [-ResultSize <Unlimited>]
   [-SortBy <String>]
   [-SourceDatabase <DatabaseIdParameter>]
   [-Status <RequestStatus>]
   [-Suspend <Boolean>]
   [-SuspendWhenReadyToComplete <Boolean>]
   [-TargetDatabase <DatabaseIdParameter>]
   [<CommonParameters>]

Descrizione

I criteri di ricerca per il cmdlet Get-MoveRequest 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-MoveRequest -Identity 'tony@contoso.com'

In questo esempio viene recuperato lo stato dello spostamento della cassetta postale in corso per la cassetta postale di Tony Smith (tony@contoso.com).

Esempio 2

Get-MoveRequest -MoveStatus InProgress -TargetDatabase DB05

Con questo esempio viene recuperato lo stato dello spostamento in corso della cassetta postale verso il database di destinazione DB05.

Esempio 3

Get-MoveRequest -BatchName "FromDB01ToDB02" -MoveStatus CompletedWithWarning

Con questo esempio viene recuperato lo stato delle richieste di spostamento nel batch FromDB01ToDB02, completato ma con avvisi.

Parametri

-BatchName

Il parametro BatchName consente di specificare il nome assegnato alla richiesta di spostamento 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

-Credential

Questo parametro è disponibile solo in Exchange locale.

Il parametro Credential consente di specificare il nome utente e la password usati per eseguire questo comando. In genere questo parametro viene utilizzato negli script o quando occorre fornire credenziali diverse con le autorizzazioni necessarie.

Un valore per questo parametro richiede il cmdlet Get-Credential. Per sospendere questo comando e visualizzare la richiesta di immissione delle credenziali, usare il valore (Get-Credential). In alternativa, prima di eseguire questo comando, archiviare le credenziali in una variabile (ad esempio, $cred = Get-Credential) e quindi usare il nome della variabile ($cred) per questo parametro. Per altre informazioni, vedere Get-Credential.

Type:	PSCredential
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

-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

-Flags

Il parametro Flags consente di specificare il tipo di spostamento per cui recuperare informazioni. È possibile utilizzare i seguenti valori:

• CrossOrg
• HighPriority
• IntraOrg
• Partecipa
• MoveOnlyArchiveMailbox
• MoveOnlyPrimaryMailbox
• Nessuno
• Offline
• Protetto
• Tirare
• Spingere
• RemoteLegacy
• Diviso
• Sospendere
• SuspendWhenReadyToComplete
• TargetIsAggregatedMailbox

Type:	RequestFlags
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, Exchange Online

-HighPriority

Questo parametro è disponibile solo in Exchange locale.

Il parametro HighPriority consente di specificare che il cmdlet restituisce le richieste create con il contrassegno HighPriority. Il contrassegno HighPriority indica che la richiesta deve essere elaborata prima delle altre richieste con priorità più bassa in coda.

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 spostamento, che indica l'identità dell'utente della cassetta postale o della posta. È possibile utilizzare qualsiasi valore che identifichi la cassetta postale o l'utente di posta in modo univoco. 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)

È possibile usare questo parametro con i parametri seguenti:

• BatchName
• HighPriority
• MoveStatus
• Offline
• Proteggere
• Remotehostname
• SourceDatabase
• Sospendere
• SuspendWhenReadyToComplete
• Database di destinazione

Type:	MoveRequestIdParameter
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

-IncludeSoftDeletedObjects

Questo parametro è disponibile solo in Exchange locale.

Il parametro IncludeSoftDeletedObjects consente di specificare se restituire le cassette postali eliminate non definitivamente. Questo parametro accetta $true o $false.

Type:	SwitchParameter
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

-MoveStatus

Il parametro MoveStatus consente di restituire le richieste di spostamento con lo stato specificato. È possibile utilizzare i seguenti valori:

• AutoSuspended
• Completata
• CompletedWithWarning
• CompletionInProgress
• Esito negativo
• Inprogress
• In coda
• Riprovare
• Sospeso

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

-Offline

Il parametro Offline consente di specificare se restituire le cassette postali spostate in modalità offline. Questo parametro accetta $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

-OrganizationalUnit

Il parametro OrganizationalUnit filtra i risultati in base alla posizione dell'oggetto in Active Directory. Vengono restituiti solo gli oggetti presenti nella posizione specificata. L'input valido per questo parametro è un'unità organizzativa o un dominio restituito dal cmdlet Get-OrganizationalUnit. È possibile utilizzare qualsiasi valore che identifichi l'unità organizzativa o il dominio in modo univoco. Ad esempio:

• Nome
• Nome
• Nome distinto (DN)
• GUID

Type:	OrganizationalUnitIdParameter
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

-Protect

Questo parametro è disponibile solo in Exchange locale.

Il parametro Protect consente di restituire le cassette postali spostate in modalità protetta. Questo parametro accetta $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

-ProxyToMailbox

Questo parametro è disponibile solamente nel servizio basato su cloud.

Il parametro ProxyToMailbox filtra i risultati in base al percorso della cassetta postale specificata (nota anche come proxy). È possibile utilizzare qualsiasi valore che identifichi la cassetta postale in modo univoco. 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)

Type:	MailboxIdParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-RemoteHostName

Il parametro RemoteHostName consente di specificare il nome di dominio completo (FQDN) dell'organizzazione tra foreste da cui si sta spostando la cassetta postale.

Non è possibile utilizzare questo parametro con il parametro Identity.

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, Exchange Online

-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

-SortBy

Il parametro SortBy consente di specificare la proprietà in base a cui ordinare i risultati. È possibile ordinare in base a una sola proprietà alla volta. I risultati vengono visualizzati in ordine crescente.

Se la visualizzazione predefinita non include la proprietà per cui si esegue l'ordinamento, è possibile accodare il comando con | Format-Table -Auto Property1,Property2,...PropertyX. per creare una nuova visualizzazione che contiene tutte le proprietà che si desidera visualizzare. I caratteri jolly (*) nei nomi di proprietà sono supportati.

È possibile eseguire l'ordinamento in base alle seguenti proprietà:

• Nome
• DisplayName
• Alias

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

-SourceDatabase

Questo parametro è disponibile solo in Exchange locale.

Il parametro SourceDatabase restituisce tutte le cassette postali che vengono spostate dal database delle cassette postali di origine specificato. È 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

Questo parametro è disponibile solamente nel servizio basato su cloud.

Il parametro Status filtra i risultati in base allo stato. I valori validi sono:

• AutoSuspended
• Completata
• CompletedWithSkippedItems
• CompletedWithWarning
• CompletionInProgress
• Esito negativo
• Inprogress
• In coda
• Riprovare
• Sospeso
• Sincronizzati

Type:	RequestStatus
Aliases:	MoveStatus
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-Suspend

Il parametro Suspend consente di specificare se restituire le cassette postali con spostamenti sospesi. Questo parametro accetta $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

-SuspendWhenReadyToComplete

Il parametro SuspendWhenReadytoComplete consente di specificare se restituire le cassette postali che sono state spostate con il comando New-MoveRequest e la sua opzione SuspendWhenReadyToComplete. Questo parametro accetta $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 locale.

Il parametro TargetDatabase restituisce tutte le cassette postali che vengono spostate nel database delle cassette postali di destinazione specificato. È 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

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.