Set-MigrationUser
Questo cmdlet funziona solo nel servizio basato sul cloud.
Utilizzare il cmdlet Set-MigrationUser per modificare le impostazioni di migrazione relative a un utente di un batch di migrazione esistente.
Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.
Sintassi
Default (Impostazione predefinita)
Set-MigrationUser
[-Identity] <MigrationUserIdParameter>
[-ApproveSkippedItems]
[-BadItemLimit <Unlimited>]
[-CompleteAfter <DateTime>]
[-Confirm]
[-DomainController <Fqdn>]
[-LargeItemLimit <Unlimited>]
[-Partition <MailboxIdParameter>]
[-StartAfter <DateTime>]
[-SyncNow]
[-WhatIf]
[<CommonParameters>]
Descrizione
Alcune impostazioni possono essere applicate sia al batch che ai singoli utenti all'interno del batch. Un'impostazione applicata a un utente sostituisce qualsiasi impostazione corrispondente nel batch.
È 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-MigrationUser -Identity laura@contoso.com -LargeItemLimit 15 -BadItemLimit 15
In questo esempio vengono modificati il limite di elementi di grandi dimensioni e il limite di elementi non valido per l'utente laura@contoso.com in un batch di migrazione esistente.
Esempio 2
Set-MigrationUser -Identity laura@contoso.com -ApproveSkippedItems
Questo esempio approva tutti gli elementi ignorati rilevati per l'utente laura@contoso.com in un batch di migrazione esistente.
Parametri
-ApproveSkippedItems
Applicabile: Exchange Online
Questo parametro è disponibile solamente nel servizio basato su cloud.
L'opzione ApproveSkippedItems contrassegna tutti gli elementi ignorati individuati prima dell'ora corrente come approvati. Con questa opzione non è necessario specificare alcun valore.
Se la perdita di dati rilevata durante questa migrazione è significativa, la migrazione non può essere completata senza approvare gli elementi ignorati. Gli elementi potrebbero essere stati ignorati perché sono danneggiati nella cassetta postale di origine e non possono essere copiati nella cassetta postale di destinazione, sono maggiori delle dimensioni massime consentite dei messaggi configurati per il tenant oppure sono stati rilevati come mancanti nella cassetta postale di destinazione quando la migrazione è pronta per il completamento.
Per altre informazioni sui valori delle dimensioni massime dei messaggi, vedere limiti di Exchange Online.
Con questa opzione non è necessario specificare alcun valore.
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 |
-BadItemLimit
Applicabile: Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Questo parametro è disponibile solo in Exchange locale.
Questo parametro è riservato all'uso interno da parte di Microsoft.
Nota: questo parametro è deprecato dal servizio basato sul cloud. Gli amministratori devono esaminare il punteggio di coerenza dei dati e tutti gli elementi ignorati prima del completamento della migrazione.
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 |
-CompleteAfter
Applicabile: Exchange Online
Questo parametro è disponibile solamente nel servizio basato su cloud.
Il parametro CompleteAfter consente di specificare un ritardo prima del completamento dell'utente. La migrazione dei dati per l'utente viene avviata, ma non viene completata fino alla data/ora specificata con questo parametro.
Usare il formato data breve definito nelle impostazioni Opzioni internazionali nel computer in cui viene eseguito il comando. Ad esempio, se il computer è configurato per l'uso del formato di data breve MM/gg/aaaa, immettere 01/09/2018 per specificare il 1° settembre 2018. È possibile immettere solo la data oppure specificare la data e l'ora del giorno. In quest'ultimo caso, racchiudere il valore tra virgolette ("), ad esempio, "01/09/2018 17:00".
In Exchange Online PowerShell, se si specifica un valore di data/ora senza un fuso orario, il valore si trova nell'ora UTC (Coordinated Universal Time).
Per specificare un valore data/ora per questo parametro, utilizzare una delle opzioni seguenti:
- Specificare il valore di data/ora in formato UTC: ad esempio, "2021-05-06 14:30:00z".
- Specificare il valore di data/ora come formula che converte la data/ora nel fuso orario locale in formato UTC: ad esempio,
(Get-Date "5/6/2021 9:30 AM").ToUniversalTime(). Per altre informazioni, vedere Get-Date.
Proprietà dei parametri
| Tipo: | DateTime |
| 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 |
-Confirm
Applicabile: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
L'opzione Confirm consente di specificare se visualizzare o nascondere la richiesta di conferma. Il modo in cui questa opzione influisce sul cmdlet dipende dal fatto che il cmdlet richieda la conferma 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, se si specifica l'opzione Conferma senza un valore, viene introdotta una sospensione che impone 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 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 |
-Identity
Applicabile: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
Il parametro Identity consente di specificare l'indirizzo di posta elettronica oggetto della migrazione.
È anche possibile identificare l'utente per il valore GUID nella proprietà MigrationUser dell'output del cmdlet Get-MigrationUser. Questo metodo di identificazione è utile se lo stesso utente è stato incluso accidentalmente in più batch.
Proprietà dei parametri
| Tipo: | MigrationUserIdParameter |
| 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 |
-LargeItemLimit
Applicabile: Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Questo parametro è disponibile solo in Exchange locale.
Questo parametro è riservato all'uso interno da parte di Microsoft.
Nota: questo parametro è deprecato dal servizio basato sul cloud. Gli amministratori devono esaminare il punteggio di coerenza dei dati e tutti gli elementi ignorati prima del completamento della migrazione.
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 |
-Partition
Applicabile: Exchange Online
Questo parametro è disponibile solamente nel servizio basato su cloud.
Questo parametro è riservato all'uso interno da parte di Microsoft.
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 |
-StartAfter
Applicabile: Exchange Online
Questo parametro è disponibile solamente nel servizio basato su cloud.
Il parametro StartAfter specifica un ritardo prima dell'avvio della migrazione dei dati per l'utente. La migrazione viene preparata, ma la migrazione effettiva dei dati per l'utente non viene avviata fino alla data/ora specificata con questo parametro.
Usare il formato data breve definito nelle impostazioni Opzioni internazionali nel computer in cui viene eseguito il comando. Ad esempio, se il computer è configurato per l'uso del formato di data breve MM/gg/aaaa, immettere 01/09/2018 per specificare il 1° settembre 2018. È possibile immettere solo la data oppure specificare la data e l'ora del giorno. In quest'ultimo caso, racchiudere il valore tra virgolette ("), ad esempio, "01/09/2018 17:00".
In Exchange Online PowerShell, se si specifica un valore di data/ora senza un fuso orario, il valore si trova nell'ora UTC (Coordinated Universal Time).
Per specificare un valore data/ora per questo parametro, utilizzare una delle opzioni seguenti:
- Specificare il valore di data/ora in formato UTC: ad esempio, "2021-05-06 14:30:00z".
- Specificare il valore di data/ora come formula che converte la data/ora nel fuso orario locale in formato UTC: ad esempio,
(Get-Date "5/6/2021 9:30 AM").ToUniversalTime(). Per altre informazioni, vedere Get-Date.
Proprietà dei parametri
| Tipo: | DateTime |
| 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 |
-SyncNow
Applicabile: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
L'opzione SyncNow consente di specificare se avviare una sincronizzazione incrementale per l'utente migrato. Con questa opzione non è necessario specificare alcun valore.
La sincronizzazione incrementale copia le modifiche recenti dalla cassetta postale di origine alla cassetta postale di destinazione. È possibile eseguire una sincronizzazione incrementale prima di completare il batch di migrazione per ridurre il tempo necessario per il completamento.
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 |
-WhatIf
Applicabile: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
L'opzione WhatIf mostra le operazioni eseguite dal comando senza apportare modifiche. 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.