Set-PublicFolderMigrationRequest
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
Identity
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>]
Rehome
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. 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
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
Applicabile: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
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.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
Identity
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-BadItemLimit
Applicabile: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
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.
Proprietà dei parametri
| Tipo: | Unlimited |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
Identity
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-BatchName
Applicabile: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
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.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
Identity
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-CompletedRequestAgeLimit
Applicabile: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
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.
Proprietà dei parametri
| Tipo: | Unlimited |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
Identity
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Confirm
Applicabile: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
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-*) dispongono di una pausa incorporata che impone all'utente 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 dispone di una pausa incorporata. 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.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | cfr |
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 2013, Exchange Server 2016, Exchange Server 2019
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 |
-Identity
Applicabile: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
Il parametro Identity consente di specificare la richiesta di migrazione da modificare. È possibile utilizzare i seguenti valori:
- Nome
- RequestGUID
Proprietà dei parametri
| Tipo: | PublicFolderMigrationRequestIdParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | 1 |
| Obbligatorio: | True |
| Valore dalla pipeline: | True |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
-InternalFlags
Applicabile: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
Il parametro InternalFlags indica i passaggi facoltativi della richiesta. Questo parametro è utilizzato principalmente a fini di debug.
Proprietà dei parametri
| Tipo: | InternalMrsFlag[] |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
Identity
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-LargeItemLimit
Applicabile: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
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.
Proprietà dei parametri
| Tipo: | Unlimited |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
Identity
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-PreventCompletion
Applicabile: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
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 valore è il valore predefinito.
Proprietà dei parametri
| Tipo: | Boolean |
| 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 |
-Priority
Applicabile: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
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
- Normale: questo valore è il valore predefinito.
- High
- Higher
- Highest
- Emergency
Proprietà dei parametri
| Tipo: | RequestPriority |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
Identity
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-RehomeRequest
Applicabile: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
L'opzione RehomeRequest indica al servizio Replica cassette postali (MRS) di Microsoft Exchange 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.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
Rehome
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-RequestExpiryInterval
Applicabile: Exchange Server 2016, Exchange Server 2019
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.
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 |
-SkipMerging
Applicabile: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
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.
Proprietà dei parametri
| Tipo: | SkippableMergeComponent[] |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
Identity
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-WhatIf
Applicabile: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
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.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | Wi |
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 |
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.