Test-MigrationServerAvailability

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 Test-MigrationServerAvailability per testare la disponibilità del server di destinazione in preparazione per eseguire spostamenti di cassette postali tra foreste, migrazione delle cassette postali locali a Exchange Online o per eseguire la migrazione dei dati delle cassette postali locali da un server IMAP a cassette postali Exchange Online. Per tutti i tipi di migrazione, il cmdlet tenta di verificare le impostazioni della connessione usate per connettersi il server di destinazione.

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

Sintassi

Test-MigrationServerAvailability
    -Credentials <PSCredential>
    -EmailAddress <SmtpAddress>
    [-Autodiscover]
    [-ExchangeRemoteMove]
    [-Confirm]
    [-Partition <MailboxIdParameter>]
    [-WhatIf]
    [<CommonParameters>]
Test-MigrationServerAvailability
    -Credentials <PSCredential>
    -EmailAddress <SmtpAddress>
    [-Autodiscover]
    [-ExchangeOutlookAnywhere]
    [-AcceptUntrustedCertificates]
    [-Confirm]
    [-MailboxPermission <MigrationMailboxPermission>]
    [-Partition <MailboxIdParameter>]
    [-SourceMailboxLegacyDN <String>]
    [-TestMailbox <MailboxIdParameter>]
    [-WhatIf]
    [<CommonParameters>]
Test-MigrationServerAvailability
    -Credentials <PSCredential>
    -RemoteServer <Fqdn>
    [-FilePath <String>]
    [-PSTImport]
    [-Confirm]
    [-Partition <MailboxIdParameter>]
    [-WhatIf]
    [<CommonParameters>]
Test-MigrationServerAvailability
    -Credentials <PSCredential>
    -ExchangeServer <String>
    -RPCProxyServer <Fqdn>
    [-ExchangeOutlookAnywhere]
    [-AcceptUntrustedCertificates]
    [-Authentication <AuthenticationMethod>]
    [-EmailAddress <SmtpAddress>]
    [-MailboxPermission <MigrationMailboxPermission>]
    [-TestMailbox <MailboxIdParameter>]
    [-SourceMailboxLegacyDN <String>]
    [-Confirm]
    [-Partition <MailboxIdParameter>]
    [-WhatIf]
    [<CommonParameters>]
Test-MigrationServerAvailability
    -Credentials <PSCredential>
    -PublicFolderDatabaseServerLegacyDN <String>
    -RPCProxyServer <Fqdn>
    -SourceMailboxLegacyDN <String>
    [-PublicFolder]
    [-Authentication <AuthenticationMethod>]
    [-Confirm]
    [-Partition <MailboxIdParameter>]
    [-TestMailbox <MailboxIdParameter>]
    [-WhatIf]
    [<CommonParameters>]
Test-MigrationServerAvailability
    -RemoteServer <Fqdn>
    [-Credentials <PSCredential>]
    [-ExchangeRemoteMove]
    [-Confirm]
    [-Partition <MailboxIdParameter>]
    [-WhatIf]
    [<CommonParameters>]
Test-MigrationServerAvailability
    -Endpoint <MigrationEndpointIdParameter>
    [-Confirm]
    [-Partition <MailboxIdParameter>]
    [-WhatIf]
    [<CommonParameters>]
Test-MigrationServerAvailability
    -RemoteServer <Fqdn>
    -Port <Int32>
    [-Imap]
    [-AcceptUntrustedCertificates]
    [-Authentication <AuthenticationMethod>]
    [-Security <NIMAPSecurityMechanism]
    [-Confirm]
    [-Partition <MailboxIdParameter>]
    [-WhatIf]
    [<CommonParameters>]
Test-MigrationServerAvailability
    -ServiceAccountKeyFileData <Byte[]>
    [-Gmail]
    [-EmailAddress <SmtpAddress>]
    [-Confirm]
    [-Partition <MailboxIdParameter>]
    [-TestMailbox <MailboxIdParameter>]
    [-WhatIf]
    [<CommonParameters>]
Test-MigrationServerAvailability
    -Credentials <PSCredential>
    -EmailAddress <SmtpAddress>
    [-Compliance]
    [-RemoteServer <Fqdn>]
    [-Confirm]
    [-Partition <MailboxIdParameter>]
    [-WhatIf]
    [<CommonParameters>]
Test-MigrationServerAvailability
    -Credentials <PSCredential>
    -RemoteServer <Fqdn>
    [-PublicFolderToUnifiedGroup]
    [-TestMailbox <MailboxIdParameter>]
    [-Confirm]
    [-Partition <MailboxIdParameter>]
    [-WhatIf]
    [<CommonParameters>]
Test-MigrationServerAvailability
    -Credentials <PSCredential>
    -PublicFolderDatabaseServerLegacyDN <String>
    -RPCProxyServer <Fqdn>
    -SourceMailboxLegacyDN <String>
    [-PublicFolderToUnifiedGroup]
    [-Authentication <AuthenticationMethod>]
    [-TestMailbox <MailboxIdParameter>]
    [-Confirm]
    [-Partition <MailboxIdParameter>]
    [-WhatIf]
    [<CommonParameters>]
Test-MigrationServerAvailability
    -Credentials <PSCredential>
    -RemoteServer <Fqdn>
    [-PublicFolder]
    [-Confirm]
    [-Partition <MailboxIdParameter>]
    [-WhatIf]
    [<CommonParameters>]

Descrizione

Il cmdlet Test-MigrationServerAvailability consente di verificare la possibilità di comunicare con il server di posta locale che contiene i dati delle cassette postali di cui si desidera eseguire la migrazione nelle cassette postali basate su cloud. Quando si esegue questo cmdlet, è necessario specificare il tipo di migrazione. È possibile specificare se comunicare con un server IMAP o con un server Exchange.

Per una migrazione IMAP, questo cmdlet utilizza il nome di dominio completo del server e un numero di porta per verificare la connessione. Se la verifica ha esito positivo, utilizzare le stesse impostazioni di connessione quando si crea una richiesta di migrazione con il cmdlet New-MigrationBatch.

Per una migrazione di Exchange, questo cmdlet usa una delle impostazioni seguenti per comunicare con il server locale:

  • Per Exchange 2003, usa il nome di dominio completo del server e le credenziali per un account amministratore che può accedere al server.
  • Per Exchange Server 2007 e versioni successive, è possibile connettersi usando il servizio di individuazione automatica e l'indirizzo di posta elettronica di un account amministratore che può accedere al server.

Se la verifica ha esito positivo, si possono usare le stesse impostazioni per creare un endpoint della migrazione. Per ulteriori informazioni consulta:

  • New-MigrationEndpoint
  • New-MigrationBatch

È 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

Test-MigrationServerAvailability -Imap -RemoteServer imap.contoso.com -Port 143

Per le migrazioni IMAP, in questo esempio viene verificata la connessione a un server di posta IMAP denominato imap.contoso.edu.

Esempio 2

$Credentials = Get-Credential

Test-MigrationServerAvailability -ExchangeOutlookAnywhere -Autodiscover -EmailAddress administrator@contoso.com -Credentials $Credentials

In questo esempio vengono usati i parametri Autodiscover e ExchangeOutlookAnywhere per verificare la connessione a un server Exchange locale in preparazione alla migrazione delle cassette postali locali a Exchange Online. È possibile usare un esempio simile per testare le impostazioni di connessione per una migrazione a fasi di Exchange o una migrazione completa di Exchange.

Esempio 3

$Credentials = Get-Credential

Test-MigrationServerAvailability -ExchangeOutlookAnywhere -ExchangeServer exch2k3.contoso.com -Credentials $Credentials -RPCProxyServer mail.contoso.com -Authentication NTLM

Questo esempio verifica la connessione a un server che esegue Microsoft Exchange Server 2003 denominato exch2k3.contoso.com e usa NTLM per il metodo di autenticazione.

Esempio 4

Test-MigrationServerAvailability -Endpoint endpoint.contoso.com

Questo esempio verifica le impostazioni di connessione a un server remoto usando le impostazioni archiviate in un endpoint di migrazione esistente in Exchange Online.

Esempio 5

$MRSEndpoints = (Get-MigrationEndpoint).Identity

Foreach ($MEP in $MRSEndpoints) {Test-MigrationServerAvailability -Endpoint $MEP}

In questo esempio vengono testati più endpoint esistenti.

Parametri

-AcceptUntrustedCertificates

Questo parametro è disponibile solamente nel servizio basato su cloud.

{{ Fill AcceptUntrustedCertificates Description }}

Type:SwitchParameter
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 locale. Utilizzare Basic o NTLM. Se non si include questo parametro, viene utilizzata l'autenticazione Basic.

Il parametro viene usato solo per le migrazioni di Exchange cutover e le migrazioni a fasi di Exchange.

Type:AuthenticationMethod
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-Autodiscover

L'opzione Di individuazione automatica specifica che il comando deve utilizzare il servizio di individuazione automatica per ottenere le impostazioni di connessione per il server di destinazione. Con questa opzione non è necessario specificare alcun valore.

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, Exchange Online

-Compliance

L'opzione Conformità specifica che il tipo di endpoint è conformità. Con questa opzione non è necessario specificare alcun valore.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, 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 un account che può accedere alle cassette postali nel server di destinazione. Specificare il nome utente nel formato dominio\nomeutente o nel formato UPN (user@example.comUser Principal Name).

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:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-EmailAddress

Il parametro EmailAddress consente di specificare l'indirizzo di posta elettronica di un account amministratore che può accedere al server remoto. Il parametro è obbligatorio quando si utilizza il parametro Autodiscover.

Type:SmtpAddress
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, Exchange Online

-Endpoint

Il parametro Endpoint consente di specificare il nome dell'endpoint della migrazione a cui connettersi. Un endpoint della migrazione contiene le impostazioni della connessione e altre impostazioni di configurazione della migrazione. Se si include questo parametro, il cmdlet Test-MigrationServerAvailability tenta di verificare la possibilità di connettersi al server remoto mediante le impostazioni dell'endpoint di migrazione.

Type:MigrationEndpointIdParameter
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, Exchange Online

-ExchangeOutlookAnywhere

Questo parametro è disponibile solamente nel servizio basato su cloud.

L'opzione ExchangeOutlookAnywhere specifica un tipo di migrazione per la migrazione delle cassette postali locali a Exchange Online. Con questa opzione non è necessario specificare alcun valore.

Usare questa opzione se si prevede di eseguire la migrazione delle cassette postali a Exchange Online usando una migrazione a fasi di Exchange o una migrazione completa di Exchange.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-ExchangeRemoteMove

L'opzione ExchangeRemoteMove specifica un tipo di migrazione in cui le cassette postali vengono spostate con la massima fedeltà tra due foreste locali o tra una foresta locale e Exchange Online. Con questa opzione non è necessario specificare alcun valore.

Usare questa opzione se si prevede di eseguire uno spostamento tra foreste o la migrazione di cassette postali tra un'organizzazione di Exchange locale e Exchange Online in una distribuzione ibrida.

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, Exchange Online

-ExchangeServer

Questo parametro è disponibile solamente nel servizio basato su cloud.

Il parametro ExchangeServer specifica il nome di dominio completo del server Exchange locale. Usare questo parametro quando si prevede di eseguire una migrazione a fasi di Exchange o una migrazione completa di Exchange. Questo parametro è obbligatorio se non si utilizza il parametro Autodiscover.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-FilePath

Il parametro FilePath consente di specificare il percorso dei file PST durante la verifica di un endpoint di migrazione di importazione PST.

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

-Gmail

Questo parametro è disponibile solamente nel servizio basato su cloud.

Il parametro Gmail specifica Gmail come tipo di migrazione. Con questa opzione non è necessario specificare alcun valore.

Questa opzione è necessaria quando si vuole eseguire la migrazione dei dati da un tenant di Google Workspace (in precedenza G Suite) alle cassette postali Exchange Online.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-Imap

Questo parametro è disponibile solamente nel servizio basato su cloud.

Il parametro Imap specifica un tipo di migrazione IMAP. Con questa opzione non è necessario specificare alcun valore.

Questa opzione è necessaria quando si vuole eseguire la migrazione dei dati da un server di posta IMAP alle cassette postali Exchange Online.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-MailboxPermission

Questo parametro è disponibile solamente nel servizio basato su cloud.

Il parametro MailboxPermission consente di specificare le autorizzazioni assegnate all'account di amministratore della migrazione definite dal parametro Credentials. L'assegnazione delle autorizzazioni consente di verificare la connettività alla cassetta postale di un utente sul server di posta di origine durante la verifica delle impostazioni di connessione in preparazione per una migrazione Exchange in fasi o completa oppure per la creazione di un endpoint di migrazione Exchange Outlook Anywhere.

Specificare uno dei seguenti valori per l'account definito dal parametro Credentials:

  • FullAccess: all'account è stata assegnata l'autorizzazione Full-Access per le cassette postali di cui verrà eseguita la migrazione.
  • Amministrazione: l'account è membro del gruppo Domain Admins nell'organizzazione che ospita le cassette postali di cui verrà eseguita la migrazione.

Il parametro non viene utilizzato per la verifica della connessione al server remoto per una migrazione remota o IMAP.

Type:MigrationMailboxPermission
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.

Il parametro Port consente di specificare il numero di porta TCP utilizzato dal processo di migrazione IMAP per la connessione al server di destinazione. Questo parametro è obbligatorio solo per le migrazioni IMAP.

Generalmente si utilizza la porta 143 per le connessioni non crittografate, la porta 143 per le connessioni TLS (Transport Layer Security) e la porta 993 per le connessioni SSL (Secure Sockets Layer).

Type:Int32
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-PSTImport

Questo parametro è disponibile solo in Exchange locale.

Questo parametro è riservato all'uso interno da parte di Microsoft.

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

-PublicFolder

Questo parametro è disponibile solamente nel servizio basato su cloud.

Questo parametro è riservato all'uso interno da parte di Microsoft.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
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:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-PublicFolderToUnifiedGroup

L'opzione PublicFolderToUnifiedGroup specifica che il tipo di endpoint è cartelle pubbliche da Gruppi di Microsoft 365. Con questa opzione non è necessario specificare alcun valore.

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

-RemoteServer

Il parametro RemoteServer consente di specificare il nome di dominio completo del server di posta locale. Questo parametro è obbligatorio solo quando si vuole eseguire uno dei seguenti tipi di migrazione:

  • Spostamento tra foreste
  • Spostamento remoto (distribuzioni ibride)
  • Migrazione IMAP
Type:Fqdn
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, Exchange Online

-RPCProxyServer

Questo parametro è disponibile solamente nel servizio basato su cloud.

Il parametro RPCProxyServer specifica il nome di dominio completo del server proxy RPC per il server Exchange locale. Questo parametro è obbligatorio se non si utilizza il parametro Autodiscover. Usare questo parametro se si prevede di eseguire una migrazione a fasi di Exchange o una migrazione completa di Exchange per eseguire la migrazione delle cassette postali a Exchange Online.

Type:Fqdn
Position:Named
Default value:None
Required:True
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:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to: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 tenterà di accedere a questa cassetta postale usando le credenziali dell'account amministratore sul server di destinazione.

Type:String
Position:Named
Default value:None
Required:True
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 tenterà 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.