Set-MigrationEndpoint
Questo cmdlet è disponibile in Exchange locale e nel servizio basato su cloud. Alcuni parametri e impostazioni possono essere esclusivi di singoli ambienti.
Usare il cmdlet Set-MigrationEndpoint per modificare le impostazioni per le migrazioni di Exchange cutover o a fasi, le migrazioni IMAP, le migrazioni di Google Workspace (in precedenza G Suite) e gli spostamenti remoti.
Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.
Sintassi
Set-MigrationEndpoint
[-Identity] <MigrationEndpointIdParameter>
[-AcceptUntrustedCertificates <Boolean>]
[-ApplicationId <String>]
[-AppSecretKeyVaultUrl <String>]
[-Authentication <AuthenticationMethod>]
[-Confirm]
[-Credentials <PSCredential>]
[-DomainController <Fqdn>]
[-ExchangeServer <String>]
[-MailboxPermission <MigrationMailboxPermission>]
[-MaxConcurrentIncrementalSyncs <Unlimited>]
[-MaxConcurrentMigrations <Unlimited>]
[-NspiServer <String>]
[-Partition <MailboxIdParameter>]
[-Port <Int32>]
[-PublicFolderDatabaseServerLegacyDN <String>]
[-RemoteServer <Fqdn>]
[-RpcProxyServer <Fqdn>]
[-Security <IMAPSecurityMechanism>]
[-ServiceAccountKeyFileData <Byte[]>]
[-SkipVerification]
[-SourceMailboxLegacyDN <String>]
[-TestMailbox <MailboxIdParameter>]
[-WhatIf]
[<CommonParameters>] Descrizione
Utilizzare il cmdlet Set-MigrationEndpoint per configurare le impostazioni per diversi tipi di migrazione:
- Spostamento tra foreste: spostare le cassette postali tra due diverse foreste di Exchange locali. Gli spostamenti tra foreste richiedono l'utilizzo di un endpoint RemoteMove.
- Spostamento remoto: in una distribuzione ibrida, uno spostamento remoto comporta migrazioni di onboarding o offboarding. Gli spostamenti remoti richiedono l'utilizzo di un endpoint RemoteMove. L'onboarding sposta le cassette postali da un'organizzazione di Exchange locale a Exchange Online e usa un endpoint RemoteMove come endpoint di origine del batch di migrazione. L'offboarding sposta le cassette postali da Exchange Online a un'organizzazione di Exchange locale e usa un endpoint RemoteMove come endpoint di destinazione del batch di migrazione.
- Migrazione completa di Exchange: eseguire la migrazione di tutte le cassette postali di un'organizzazione di Exchange locale a Exchange Online. La migrazione completa di Exchange richiede l'uso di un endpoint di Exchange.
- Migrazione a fasi di Exchange: eseguire la migrazione di un subset di cassette postali da un'organizzazione di Exchange locale a Exchange Online. La migrazione a fasi di Exchange richiede l'uso di un endpoint di Exchange.
- Migrazione IMAP: eseguire la migrazione dei dati delle cassette postali da un'organizzazione di Exchange locale o da un altro sistema di posta elettronica a Exchange Online. Per una migrazione IMAP, è necessario creare le cassette postali basate su cloud prima di eseguire la migrazione dei dati delle cassette postali. Le migrazioni IMAP richiedono l'utilizzo di un endpoint IMAP.
- Migrazione di Gmail: migrazione dei dati delle cassette postali da un tenant di Google Workspace a Exchange Online. Per una migrazione di Google Workspace, prima di eseguire la migrazione dei dati delle cassette postali è necessario creare gli utenti o le cassette postali basati sul cloud. Le migrazioni di Google Workspace richiedono l'uso di un endpoint Gmail.
- Locale: spostare le cassette postali tra server o database diversi all'interno di una singola foresta di Exchange locale. Gli spostamenti locali non richiedono l'utilizzo di un endpoint.
Per ulteriori informazioni sui diversi scenari di spostamento e migrazione, vedere:
- La cassetta postale si sposta in Exchange Server
- Gestire gli spostamenti delle cassette postali locali in Exchange Server
Le modifiche apportate a un endpoint che interessano i singoli utenti all'interno del batch vengono applicate a partire dalla successiva elaborazione del batch. Se si esegue questo cmdlet nel servizio basato sul cloud e si vuole velocizzare l'applicazione di queste impostazioni, provare a eseguire il cmdlet Set-MigrationBatch con il parametro -Update.
È 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-MigrationEndpoint -Identity CutoverExchangeEndpoint01 -MaxConcurrentIncrementalSyncs 50 -NspiServer Server01.contoso.comIn questo esempio l'impostazione di MaxConcurrentIncrementalSyncs viene modificata in 50 sull'endpoint di migrazione CutoverExchangeEndpoint01 utilizzando il server NSPI Server01.
Esempio 2
Set-MigrationEndpoint -Identity Onboardingmigrationendpoint01 -MaxConcurrentMigrations 10 -RemoteServer Server01.contoso.comIn questo esempio l'impostazione di MaxConcurrentMigrations viene modificata in 10 sull'endpoint di migrazione Onboardingmigrationendpoint01 utilizzando il server remoto Server01.
Parametri
-AcceptUntrustedCertificates
Questo parametro è disponibile solamente nel servizio basato su cloud.
{{ Fill AcceptUntrustedCertificates Description }}
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-ApplicationId
Questo parametro è disponibile solamente nel servizio basato su cloud.
{{ Fill ApplicationId Description }}
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-AppSecretKeyVaultUrl
Questo parametro è disponibile solamente nel servizio basato su cloud.
{{ Fill AppSecretKeyVaultUrl Description }}
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-Authentication
Questo parametro è disponibile solamente nel servizio basato su cloud.
Il parametro Authentication consente di specificare il metodo di autenticazione utilizzato dal server di posta elettronica remoto.
| Type: | AuthenticationMethod |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-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, Exchange Online |
-Credentials
Il parametro Credentials consente di specificare il nome utente e la password per la connessione all'endpoint remoto. Le credenziali devono essere usate quando si crea un endpoint di Exchange a fasi o cutover o un endpoint RemoteMove.
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 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 |
-ExchangeServer
Questo parametro è disponibile solamente nel servizio basato su cloud.
Il parametro ExchangeServer specifica il server Exchange di origine locale per le migrazioni cutover e a fasi. Questo parametro è applicabile solo agli endpoint di Exchange a fasi e cutover che non usano l'individuazione automatica.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-Identity
Il parametro Identity consente di specificare il nome dell'endpoint della migrazione che si desidera configurare.
| Type: | MigrationEndpointIdParameter |
| 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, Exchange Online |
-MailboxPermission
Questo parametro è disponibile solamente nel servizio basato su cloud.
Il parametro MailboxPermission consente di specificare le autorizzazioni da utilizzare per accedere alla cassetta postale di origine durante l'onboarding di OutlookAnywhere (migrazione di Exchange in fasi e migrazione completa di Exchange). Questo parametro non si applica alle migrazioni non OutlookAnywhere.
L'account specificato deve disporre delle seguenti autorizzazioni:
- Autorizzazione FullAccess. L'account dispone dell'autorizzazione di accesso completo alle cassette postali da migrare.
- Autorizzazioni Admin. L'account è un amministratore di dominio che può accedere a qualsiasi cassetta postale da migrare,.
| Type: | MigrationMailboxPermission |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-MaxConcurrentIncrementalSyncs
Il parametro MaxConcurrentIncrementalSyncs consente di specificare il numero massimo di sincronizzazioni incrementali consentite per questo endpoint in un dato momento. Questo valore deve essere minore o uguale al parametro MaxConcurrentMigrations.
| 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 |
-MaxConcurrentMigrations
Il parametro MaxConcurrentMigrations consente di specificare il numero massimo totale di cassette postali che possono essere migrate per questo endpoint in un dato momento. Questo parametro è utilizzabile per tutti i tipi di migrazione.
| 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 |
-NspiServer
Questo parametro è disponibile solamente nel servizio basato su cloud.
Il parametro NspiServer consente di specificare il nome di dominio completo del server NSPI remoto. Questo parametro è applicabile solo agli endpoint di Exchange a fasi e cutover che non usano l'individuazione automatica.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-Partition
Questo parametro è disponibile solamente nel servizio basato su cloud.
Questo parametro è riservato all'uso interno da parte di Microsoft.
| Type: | MailboxIdParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-Port
Questo parametro è disponibile solamente nel servizio basato su cloud.
Nel caso di una migrazione IMAP, il parametro Port consente di specificare il numero di porta TCP utilizzato dal processo di migrazione per la connessione al server remoto.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-PublicFolderDatabaseServerLegacyDN
Questo parametro è disponibile solamente nel servizio basato su cloud.
Questo parametro è riservato all'uso interno da parte di Microsoft.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-RemoteServer
Il parametro RemoteServer specifica il server remoto a seconda del tipo di protocollo per gli spostamenti:
- Exchange Server si sposta: fqdn di un server Exchange con il ruolo Accesso client installato, un array di server Accesso client o un gruppo di server Accesso client che si trovano dietro un servizio di bilanciamento del carico di rete supportato.
- IMAP si sposta: fqdn del server IMAP.
| 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, Exchange Online |
-RpcProxyServer
Questo parametro è disponibile solamente nel servizio basato su cloud.
Per una migrazione a fasi di Exchange, il parametro RpcProxyServer specifica il nome di dominio completo del server proxy RPC per il server Exchange locale. Questo parametro è applicabile solo agli endpoint di Exchange a fasi e cutover che non usano l'individuazione automatica
| Type: | Fqdn |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-Security
Questo parametro è disponibile solamente nel servizio basato su cloud.
Per una migrazione IMAP, il parametro Security specifica il metodo di crittografia usato dal server di posta elettronica remoto. Le opzioni valide sono None, Tls o Ssl.
| Type: | IMAPSecurityMechanism |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-ServiceAccountKeyFileData
Questo parametro è disponibile solamente nel servizio basato su cloud.
Il parametro ServiceAccountKeyFileData viene usato per specificare le informazioni necessarie per l'autenticazione come account del servizio. I dati devono provenire dal file di chiave JSON scaricato quando viene creato l'account del servizio a cui è stato concesso l'accesso al tenant remoto.
Per un valore valido per questo parametro è necessario leggere il file in un oggetto con codifica byte usando la sintassi seguente: ([System.IO.File]::ReadAllBytes('<Path>\<FileName>')). È possibile usare questo comando come valore del parametro oppure scrivere l'output in una variabile ($data = [System.IO.File]::ReadAllBytes('<Path>\<FileName>')) e usare la variabile come valore del parametro ($data).
| Type: | Byte[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-SkipVerification
L'opzione SkipVerification ignora la verifica che il server remoto sia raggiungibile durante la creazione di un endpoint di migrazione. Con questa opzione non è necessario specificare alcun valore.
| 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, Exchange Online |
-SourceMailboxLegacyDN
Questo parametro è disponibile solamente nel servizio basato su cloud.
Il parametro SourceMailboxLegacyDN consente di specificare una cassetta postale sul server di destinazione. Usare il valore LegacyExchangeDN della cassetta postale di prova locale come valore per questo parametro. Il cmdlet tenta di accedere a questa cassetta postale usando le credenziali dell'account amministratore sul server di destinazione.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-TestMailbox
Questo parametro è disponibile solamente nel servizio basato su cloud.
Il parametro TestMailbox consente di specificare una cassetta postale sul server di destinazione. Utilizzare l'indirizzo SMTP primario come valore per questo parametro. Il cmdlet tenta di accedere a questa cassetta postale usando le credenziali dell'account amministratore sul server di destinazione.
| Type: | MailboxIdParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-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, Exchange Online |
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.