Set-PublicFolderMigrationRequest

Modulo:

ExchangePowerShell

Si applica a:

Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

Questo cmdlet è disponibile solo in Exchange locale.

Usare il cmdlet Set-PublicFolderMigrationRequest per modificare le richieste di migrazione di cartelle pubbliche seriali (richieste create dal cmdlet New-PublicFolderMigrationRequest). È possibile usare questo cmdlet per eseguire il ripristino da richieste di migrazione non riuscite.

Nota: il supporto per la migrazione seriale delle cartelle pubbliche è terminato con l'aggiornamento cumulativo 8 (CU8) di Exchange 2013 e i cmdlet non sono più disponibili in Exchange Online. Usare invece i cmdlet *-MigrationBatch e *-PublicFolderMailboxMigration* corrispondenti.

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

Sintassi

Set-PublicFolderMigrationRequest
   [-Identity] <PublicFolderMigrationRequestIdParameter>
   [-AcceptLargeDataLoss]
   [-BadItemLimit <Unlimited>]
   [-BatchName <String>]
   [-CompletedRequestAgeLimit <Unlimited>]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-InternalFlags <InternalMrsFlag[]>]
   [-LargeItemLimit <Unlimited>]
   [-PreventCompletion <Boolean>]
   [-Priority <RequestPriority>]
   [-RequestExpiryInterval <Unlimited>]
   [-SkipMerging <SkippableMergeComponent[]>]
   [-WhatIf]
   [<CommonParameters>]

Set-PublicFolderMigrationRequest
   [-Identity] <PublicFolderMigrationRequestIdParameter>
   -RehomeRequest
   [-Confirm]
   [-DomainController <Fqdn>]
   [-PreventCompletion <Boolean>]
   [-RequestExpiryInterval <Unlimited>]
   [-WhatIf]
   [<CommonParameters>]

Descrizione

È possibile inviare tramite pipe l'output di Get-PublicFolderMigrationRequestStatistics, Get-PublicFolderMigrationRequest o Get-PublicFolder a questo cmdlet.

È 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

Set-PublicFolderMigrationRequest -Identity PublicFolderMigration -BadItemLimit 5

In questo esempio viene modificata l'impostazione della richiesta di migrazione PublicFolderMigration in modo da accettare fino a cinque elementi delle cartelle pubbliche danneggiati.

Parametri

-AcceptLargeDataLoss

L'opzione AcceptLargeDataLoss consente di specificare che la richiesta deve proseguire anche se non è possibile copiare nella cassetta postale di destinazione un gran numero di elementi della cassetta postale di origine. Con questa opzione non è necessario specificare alcun valore.

È necessario usare questa opzione se si imposta il parametro LargeItemLimit su un valore pari o superiore a 51. In caso contrario, il comando avrà esito negativo.

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

-BadItemLimit

Il parametro BadItemLimit consente di specificare il numero massimo di elementi non validi consentiti prima che la richiesta abbia un esito negativo. Un elemento non valido è un elemento danneggiato nella cassetta postale di origine che non è possibile copiare nella cassetta postale di destinazione. Rientrano negli elementi non validi anche gli elementi mancanti. Gli elementi mancanti sono elementi nella cassetta postale di origine che non è possibile rilevare nella cassetta postale di destinazione quando la richiesta è pronta per essere completata.

L'input valido per questo parametro è un numero intero o il valore Unlimited. Il valore predefinito è 0, che indica che la richiesta avrà esito negativo se vengono rilevati elementi non validi. Se si decide di lasciare alcuni elementi non validi, è possibile impostare questo parametro su un valore ragionevole (si consiglia 10 o un valore inferiore) in modo da consentire l'elaborazione della richiesta. In caso di rilevamento di un numero eccessivo di elementi non validi, provare a utilizzare il cmdlet New-MailboxRepairRequest per tentare di correggere gli elementi corrotti nella cassetta postale di origine e procedere di nuovo con la richiesta.

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

-BatchName

Il parametro BatchName consente di specificare un nome descrittivo per la migrazione di un batch di cartelle pubbliche. È possibile utilizzare il parametro BatchName come stringa di ricerca quando si utilizza il cmdlet Get-PublicFolderMigrationRequest.

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

-CompletedRequestAgeLimit

Il parametro CompletedRequestAgeLimit consente di specificare per quanto tempo viene conservata la richiesta dopo il completamento e prima di essere rimossa automaticamente. Il valore predefinito del parametro CompletedRequestAgeLimit è 30 giorni.

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

-Confirm

L'opzione Confirm consente di specificare se visualizzare o nascondere la richiesta di conferma. L'impatto di questa opzione sul cmdlet dipende dalla richiesta di conferma del cmdlet prima di procedere.

• I cmdlet distruttivi , ad esempio i cmdlet Remove-*, hanno una pausa predefinita che impone di confermare il comando prima di procedere. Per questi cmdlet, è possibile ignorare la richiesta di conferma usando questa precisa sintassi: -Confirm:$false.
• La maggior parte degli altri cmdlet (ad esempio, i cmdlet New-* e Set-*) non hanno una pausa predefinita. Per questi cmdlet, specificando l'opzione Confirm senza un valore viene introdotta una pausa che impone all'utente di confermare il comando prima di procedere.

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

-DomainController

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

-Identity

Il parametro Identity consente di specificare la richiesta di migrazione da modificare. È possibile utilizzare i seguenti valori:

• Nome
• RequestGUID

Type:	PublicFolderMigrationRequestIdParameter
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-InternalFlags

Il parametro InternalFlags indica i passaggi facoltativi della richiesta. Questo parametro è utilizzato principalmente a fini di debug.

Type:	InternalMrsFlag[]
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

-LargeItemLimit

Il parametro LargeItemLimit consente di specificare il numero massimo di elementi di grandi dimensioni consentiti prima che la richiesta abbia un esito negativo. Un elemento di grandi dimensioni è un messaggio nella cassetta postale di origine che supera la dimensione massima dei messaggi consentita nella cassetta postale di destinazione. Se la cassetta postale di destinazione non dispone di un valore di dimensione massima dei messaggi configurato in modo specifico, viene utilizzato il valore al livello dell'organizzazione.

Per ulteriori informazioni sui valori della dimensione massima dei messaggi, vedere i seguenti argomenti:

• Exchange 2016: limiti delle dimensioni dei messaggi in Exchange Server
• Exchange Online: Limiti di Exchange Online

L'input valido per questo parametro è un numero intero o il valore Unlimited. Il valore predefinito è 0, che indica che la richiesta avrà esito negativo se vengono rilevati elementi di grandi dimensioni. Se si decide di lasciare alcuni elementi di grandi dimensioni, è possibile impostare questo parametro su un valore ragionevole (si consiglia 10 o un valore inferiore) in modo da consentire l'elaborazione della richiesta.

Se si imposta il valore su 51 o su un valore maggiore, è necessario utilizzare anche l'opzione AcceptLargeDataLoss. In caso contrario, il comando avrà esito negativo.

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

-PreventCompletion

Il parametro PreventCompletion consente di specificare se eseguire la richiesta di migrazione, ma non consente di completarla. I valori validi sono:

• $true: la richiesta di migrazione viene eseguita, ma non è consentita per il completamento. Per completare la richiesta di migrazione, impostare questo parametro su $false prima di eseguire il cmdlet Resume-PublicFolderMigrationRequest.
• $false: la richiesta di migrazione viene eseguita e può essere completata. Questo è il valore predefinito.

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

-Priority

Il parametro Priority consente di specificare l'ordine di elaborazione della richiesta nella coda delle richieste. Le richieste vengono elaborate con un ordine basato sull'integrità, lo stato, la priorità e l'ora di ultimo aggiornamento del server. I valori di priorità validi sono:

• Lowest
• Lower
• Low
• Normal: questo è il valore predefinito.
• High
• Higher
• Highest
• Emergency

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

-RehomeRequest

L'opzione RehomeRequest indica al Microsoft servizio Replica cassette postali di Exchange (MRS) che la richiesta deve essere spostata nello stesso database della cartella pubblica di cui viene eseguita la migrazione. Con questa opzione non è necessario specificare alcun valore.

Questa opzione viene usata principalmente a scopo di debug.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-RequestExpiryInterval

Il parametro RequestExpiryInterval consente di specificare un periodo di validità per una richiesta completata o non riuscita. Quando si utilizza questo parametro, la richiesta completata o non riuscita viene rimossa automaticamente dopo la scadenza dell'intervallo specificato. Se non si utilizza questo parametro:

• La richiesta completata viene rimossa automaticamente in base al valore del parametro CompletedRequestAgeLimit.
• Se la richiesta ha esito negativo, è necessario rimuoverla manualmente usando il cmdlet Remove-*Request corrispondente.

Per specificare un valore, immetterlo come intervallo di tempo: dd.hh:mm:ss dove dd = days, hh = hours, mm = minuti e ss = secondi.

Quando si utilizza il valore Unlimited, la richiesta completata non viene rimossa automaticamente.

Type:	Unlimited
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2016, Exchange Server 2019

-SkipMerging

Il parametro SkipMerging specifica se alcune fasi della migrazione devono essere saltate a scopo diagnostico. Non utilizzare il parametro a meno che indicato dal Servizio Supporto Tecnico Clienti Microsoft o dalla documentazione specifica.

Type:	SkippableMergeComponent[]
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

-WhatIf

L'opzione WhatIf consente di simulare le azioni del comando. È possibile utilizzare tale opzione per visualizzare le modifiche che verrebbero applicate senza effettivamente applicarle. Con questa opzione non è necessario specificare alcun valore.

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

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.