Get-MoveRequest
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 DB05Con 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 CompletedWithWarningCon 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.