Condividi tramite

Get-PublicFolderMailboxMigrationRequest

  • Riferimento
Modulo:
ExchangePowerShell
Si applica a:
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-PublicFolderMailboxMigrationRequest per visualizzare lo stato di singoli processi in un batch di migrazione di cartelle pubbliche creati utilizzando il cmdlet New-MigrationBatch.

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

Sintassi

Get-PublicFolderMailboxMigrationRequest
   [-BatchName <String>]
   [-DomainController <Fqdn>]
   [-HighPriority <Boolean>]
   [-Name <String>]
   [-RequestQueue <DatabaseIdParameter>]
   [-ResultSize <Unlimited>]
   [-Status <RequestStatus>]
   [-Suspend <Boolean>]
   [<CommonParameters>]
Get-PublicFolderMailboxMigrationRequest
   [[-Identity] <PublicFolderMailboxMigrationRequestIdParameter>]
   [-DomainController <Fqdn>]
   [-ResultSize <Unlimited>]
   [<CommonParameters>]

Descrizione

Il cmdlet Get-PublicFolderMailboxMigrationRequest consente di visualizzare le proprietà seguenti per impostazione predefinita.

  • Nome: nome assegnato dal sistema a un processo di migrazione della cassetta postale specifico.
  • TargetMailbox: cassetta postale di cui viene eseguita la migrazione.
  • Stato: stato corrente del processo.

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

In questo esempio vengono restituite informazioni su tutte le richieste di migrazione.

Esempio 2

Get-PublicFolderMailboxMigrationRequest -HighPriority $true

In Exchange locale questo esempio restituisce tutte le richieste di migrazione con valore di priorità Alto, Superiore, Massimo o Emergenza.

Esempio 3

Get-PublicFolderMailboxMigrationRequest | ?{$_.TargetMailbox -eq $null}

In questo esempio vengono restituite le richieste di migrazione delle cassette postali per cartelle pubbliche che non dispongono di una cassetta postale di destinazione.

Esempio 4

Get-PublicFolderMailboxMigrationRequest | group TargetMailbox |?{$_.Count -gt 1}

In questo esempio vengono restituite richieste di migrazione di cartelle pubbliche duplicate (richieste create per la stessa cassetta postale di destinazione). Se il comando non restituisce alcun risultato, non sono presenti richieste di migrazione duplicate.

Parametri

-BatchName

Il parametro BatchName consente di filtrare i risultati per il breve BatchName valore assegnato al momento della creazione del processo batch. Il formato di questo valore è: MigrationService:<Batch name provided at batch creation>.

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 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-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 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 2013, Exchange Server 2016, Exchange Server 2019

-Identity

Il parametro Identity consente di specificare la richiesta di migrazione delle cassette postali di cartelle pubbliche che si desidera visualizzare. Il valore usa la sintassi: \PublicFolderMailboxMigration<GUID> (ad esempio, \PublicFolderMailboxMigrationac6d9eb4-ee49-405f-b90d-04e9a258bd7e).

Non è possibile utilizzare questo parametro con i seguenti parametri.

  • BatchName
  • HighPriority
  • Nome
  • RequestQueue
  • Sospendere
  • Stato
Type:PublicFolderMailboxMigrationRequestIdParameter
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-Name

Il parametro Name consente di specificare il nome della richiesta di migrazione delle cassette postali di cartelle pubbliche. Se il nome non è stato specificato al momento della creazione, il valore predefinito è PublicFolderMailboxMigration<GUID> , PublicFolderMailboxMigration2ffdef13-01b9-4586-af2b-d5a5482010a8ad esempio .

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

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

-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 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online