Condividi tramite

Get-MoveRequest

Modulo:
Exchange PowerShell

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

Identity 

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

Filtering 

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

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

Filtering
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Credential

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

Proprietà dei parametri

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

-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

-Flags

Applicabile: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

Il parametro Flags consente di specificare il tipo di spostamento per cui recuperare informazioni. I valori validi sono i seguenti:

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

Proprietà dei parametri

Tipo:RequestFlags
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

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

Proprietà dei parametri

Tipo:Boolean
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

Filtering
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 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\Nome utente
  • 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

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

-IncludeSoftDeletedObjects

Applicabile: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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.

Proprietà dei parametri

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

-MoveStatus

Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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.

Proprietà dei parametri

Tipo:RequestStatus
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

Filtering
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Offline

Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

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.

Proprietà dei parametri

Tipo:Boolean
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

Filtering
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-OrganizationalUnit

Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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

Proprietà dei parametri

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

-Protect

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

Proprietà dei parametri

Tipo:Boolean
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

Filtering
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-ProxyToMailbox

Applicabile: Exchange Online

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\Nome utente
  • Indirizzo di posta elettronica
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • ID utente o Nome entità utente (UPN)

Proprietà dei parametri

Tipo:MailboxIdParameter
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

-RemoteHostName

Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

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.

Proprietà dei parametri

Tipo:Fqdn
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

Filtering
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

-SortBy

Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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

Proprietà dei parametri

Tipo:String
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

-SourceDatabase

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

Proprietà dei parametri

Tipo:DatabaseIdParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

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

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

Proprietà dei parametri

Tipo:RequestStatus
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:MoveStatus

Set di parametri

Filtering
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 cassette postali con spostamenti sospesi. Questo parametro accetta $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

Filtering
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-SuspendWhenReadyToComplete

Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

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.

Proprietà dei parametri

Tipo:Boolean
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

Filtering
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-TargetDatabase

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

Proprietà dei parametri

Tipo:DatabaseIdParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

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