Test-MigrationServerAvailability

구문

ExchangeRemoteMoveAutodiscover

Test-MigrationServerAvailability
    -Credentials <PSCredential>
    -EmailAddress <SmtpAddress>
    [-Autodiscover]
    [-ExchangeRemoteMove]
    [-Confirm]
    [-Partition <MailboxIdParameter>]
    [-WhatIf]
    [<CommonParameters>]

ExchangeOutlookAnywhereAutodiscover

Test-MigrationServerAvailability
    -Credentials <PSCredential>
    -EmailAddress <SmtpAddress>
    [-Autodiscover]
    [-ExchangeOutlookAnywhere]
    [-AcceptUntrustedCertificates]
    [-Confirm]
    [-MailboxPermission <MigrationMailboxPermission>]
    [-Partition <MailboxIdParameter>]
    [-SourceMailboxLegacyDN <String>]
    [-TestMailbox <MailboxIdParameter>]
    [-WhatIf]
    [<CommonParameters>]

PSTImport

Test-MigrationServerAvailability
    -Credentials <PSCredential>
    -RemoteServer <Fqdn>
    [-FilePath <String>]
    [-PSTImport]
    [-Confirm]
    [-Partition <MailboxIdParameter>]
    [-WhatIf]
    [<CommonParameters>]

ExchangeOutlookAnywhere

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>]

PublicFolder

Test-MigrationServerAvailability
    -Credentials <PSCredential>
    -PublicFolderDatabaseServerLegacyDN <String>
    -RPCProxyServer <Fqdn>
    -SourceMailboxLegacyDN <String>
    [-PublicFolder]
    [-Authentication <AuthenticationMethod>]
    [-Confirm]
    [-Partition <MailboxIdParameter>]
    [-TestMailbox <MailboxIdParameter>]
    [-WhatIf]
    [<CommonParameters>]

ExchangeRemoteMove

Test-MigrationServerAvailability
    -RemoteServer <Fqdn>
    [-Credentials <PSCredential>]
    [-ExchangeRemoteMove]
    [-Confirm]
    [-Partition <MailboxIdParameter>]
    [-WhatIf]
    [<CommonParameters>]

TestEndpoint

Test-MigrationServerAvailability
    -Endpoint <MigrationEndpointIdParameter>
    [-Confirm]
    [-Partition <MailboxIdParameter>]
    [-WhatIf]
    [<CommonParameters>]

IMAP

Test-MigrationServerAvailability
    -RemoteServer <Fqdn>
    -Port <Int32>
    [-Imap]
    [-AcceptUntrustedCertificates]
    [-Authentication <AuthenticationMethod>]
    [-Security <<NIMAPSecurityMechanism]>]
    [-Confirm]
    [-Partition <MailboxIdParameter>]
    [-WhatIf]
    [<CommonParameters>]

Gmail

Test-MigrationServerAvailability
    -ServiceAccountKeyFileData <Byte[]>
    [-Gmail]
    [-EmailAddress <SmtpAddress>]
    [-Confirm]
    [-Partition <MailboxIdParameter>]
    [-TestMailbox <MailboxIdParameter>]
    [-WhatIf]
    [<CommonParameters>]

Compliance

Test-MigrationServerAvailability
    -Credentials <PSCredential>
    -EmailAddress <SmtpAddress>
    [-Compliance]
    [-RemoteServer <Fqdn>]
    [-Confirm]
    [-Partition <MailboxIdParameter>]
    [-WhatIf]
    [<CommonParameters>]

MrsProxyPublicFolderToUnifiedGroup

Test-MigrationServerAvailability
    -Credentials <PSCredential>
    -RemoteServer <Fqdn>
    [-PublicFolderToUnifiedGroup]
    [-TestMailbox <MailboxIdParameter>]
    [-Confirm]
    [-Partition <MailboxIdParameter>]
    [-WhatIf]
    [<CommonParameters>]

LegacyPublicFolderToUnifiedGroup

Test-MigrationServerAvailability
    -Credentials <PSCredential>
    -PublicFolderDatabaseServerLegacyDN <String>
    -RPCProxyServer <Fqdn>
    -SourceMailboxLegacyDN <String>
    [-PublicFolderToUnifiedGroup]
    [-Authentication <AuthenticationMethod>]
    [-TestMailbox <MailboxIdParameter>]
    [-Confirm]
    [-Partition <MailboxIdParameter>]
    [-WhatIf]
    [<CommonParameters>]

MrsProxyPublicFolder

Test-MigrationServerAvailability
    -Credentials <PSCredential>
    -RemoteServer <Fqdn>
    [-PublicFolder]
    [-Confirm]
    [-Partition <MailboxIdParameter>]
    [-WhatIf]
    [<CommonParameters>]

Description

예제

예 1

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

예 2

$Credentials = Get-Credential

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

예 3

$Credentials = Get-Credential

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

예 4

Test-MigrationServerAvailability -Endpoint endpoint.contoso.com

예 5

$MRSEndpoints = (Get-MigrationEndpoint).Identity

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

매개 변수

-AcceptUntrustedCertificates

적용 가능: Exchange Online

이 매개 변수는 클라우드 기반 서비스에서만 사용할 수 있습니다.

{{ Fill AcceptUntrustedCertificates Description }}

매개 변수 속성

매개 변수 집합

-Authentication

적용 가능: Exchange Online

이 매개 변수는 클라우드 기반 서비스에서만 사용할 수 있습니다.

Authentication 매개 변수는 온-프레미스 메일 서버에서 사용되는 인증 방법을 지정합니다. Basic 또는 NTLM을 사용합니다. 이 매개 변수를 포함하지 않을 경우 Basic 인증이 사용됩니다.

매개 변수는 단독형 Exchange 마이그레이션 및 준비된 Exchange 마이그레이션에만 사용됩니다.

매개 변수 속성

매개 변수 집합

-Autodiscover

적용 가능: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

자동 검색 스위치는 명령이 자동 검색 서비스를 사용하여 대상 서버에 대한 연결 설정을 가져오도록 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

매개 변수 속성

매개 변수 집합

-Compliance

적용 가능: Exchange Server 2016, Exchange Server 2019, Exchange Online

준수 스위치는 엔드포인트 유형이 규정 준수임을 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

매개 변수 속성

매개 변수 집합

-Confirm

적용 가능: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

Confirm 스위치는 확인 메시지를 표시할지 여부를 지정합니다. 진행하기 전에 cmdlet이 확인을 요구하는지에 따라 이 스위치가 cmdlet에 미치는 영향이 달라집니다.

• 파괴적인 cmdlet(예: Remove-* cmdlet)에는 계속하기 전에 명령을 강제로 승인하도록 하는 일시 중지 기능이 기본 제공되어 있습니다. 이러한 cmdlet의 경우 정확한 구문 -Confirm:$false를 사용하여 확인 메시지를 건너뛸 수 있습니다.
• 대부분 다른 cmdlets에는 (예:, New-* and Set-* cmdlets) 중단 기능이 기본 제공되지 않습니다. 이러한 cmdlet의 경우 값 없이 스위치를 지정하면 계속하기 전에 명령을 강제로 확인하도록 하는 일시 중지가 추가됩니다.

매개 변수 속성

매개 변수 집합

-Credentials

적용 가능: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

Credentials 매개 변수는 대상 서버의 사서함에 액세스할 수 있는 계정의 사용자 이름과 암호를 지정합니다. domain\username 형식 또는 UPN(사용자 계정 이름) 형식(예 user@contoso.com: )으로 사용자 이름을 지정합니다.

이 매개 변수의 값에는 Get-Credential cmdlet이 있어야 합니다. 이 명령을 일시 중지 하고 자격 증명을 입력 하라는 메시지가 표시 되면 (Get-Credential)값을 사용 합니다. 또는이 명령을 실행 하기 전에 자격 증명을 변수에 저장 (예: $cred = Get-Credential) 한 다음이 매개 변수에 대 한 변수 이름 ($cred)을 사용 합니다. 자세한 내용은 Get-Credential을 참조하세요.

매개 변수 속성

매개 변수 집합

-EmailAddress

적용 가능: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

EmailAddress 매개 변수는 원격 서버에 액세스할 수 있는 관리자 계정의 전자 메일 주소를 지정합니다. 이 매개 변수는 Autodiscover 매개 변수를 사용하는 경우 필요합니다.

매개 변수 속성

매개 변수 집합

-Endpoint

적용 가능: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

Endpoint 매개 변수는 연결할 마이그레이션 끝점의 이름을 지정합니다. 마이그레이션 끝점에는 연결 설정 및 기타 마이그레이션 구성 설정이 포함됩니다. 이 매개 변수를 포함하면 Test-MigrationServerAvailability cmdlet이 마이그레이션 끝점의 설정을 사용하여 원격 서버에 연결할 수 있는지 확인합니다.

매개 변수 속성

매개 변수 집합

-ExchangeOutlookAnywhere

적용 가능: Exchange Online

이 매개 변수는 클라우드 기반 서비스에서만 사용할 수 있습니다.

ExchangeOutlookAnywhere 스위치는 온-프레미스 사서함을 Exchange Online 마이그레이션하기 위한 마이그레이션 유형을 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

준비된 Exchange 마이그레이션 또는 단독형 Exchange 마이그레이션을 사용하여 사서함을 Exchange Online 마이그레이션하려는 경우 이 스위치를 사용합니다.

매개 변수 속성

매개 변수 집합

-ExchangeRemoteMove

적용 가능: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

ExchangeRemoteMove 스위치는 사서함이 두 온-프레미스 포리스트 간 또는 온-프레미스 포리스트와 Exchange Online 간에 완전한 충실도로 이동하는 마이그레이션 유형을 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

포리스트 간 이동을 수행하거나 온-프레미스 Exchange organization 간에 사서함을 마이그레이션하고 하이브리드 배포에서 Exchange Online 경우 이 스위치를 사용합니다.

매개 변수 속성

매개 변수 집합

-ExchangeServer

적용 가능: Exchange Online

이 매개 변수는 클라우드 기반 서비스에서만 사용할 수 있습니다.

ExchangeServer 매개 변수는 온-프레미스 Exchange 서버의 FQDN을 지정합니다. 스테이징된 Exchange 마이그레이션 또는 단독형 Exchange 마이그레이션을 수행하려는 경우 이 매개 변수를 사용합니다. Autodiscover 매개 변수를 사용하지 않는 경우 이 매개 변수가 필요합니다.

매개 변수 속성

매개 변수 집합

-FilePath

적용 가능: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

FilePath 매개 변수는 PST 가져오기 마이그레이션 끝점을 테스트할 때 PST 파일을 포함하는 경로를 지정합니다.

매개 변수 속성

매개 변수 집합

-Gmail

적용 가능: Exchange Online

이 매개 변수는 클라우드 기반 서비스에서만 사용할 수 있습니다.

Gmail 매개 변수는 Gmail을 마이그레이션 유형으로 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

이 스위치는 Google Workspace(이전의 G Suite) 테넌트에서 Exchange Online 사서함으로 데이터를 마이그레이션하려는 경우에 필요합니다.

매개 변수 속성

매개 변수 집합

-Imap

적용 가능: Exchange Online

이 매개 변수는 클라우드 기반 서비스에서만 사용할 수 있습니다.

Imap 매개 변수는 IMAP 마이그레이션 유형을 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

이 스위치는 IMAP 메일 서버에서 Exchange Online 사서함으로 데이터를 마이그레이션하려는 경우에 필요합니다.

매개 변수 속성

매개 변수 집합

-MailboxPermission

적용 가능: Exchange Online

이 매개 변수는 클라우드 기반 서비스에서만 사용할 수 있습니다.

MailboxPermission 매개 변수는 Credentials 매개 변수에 의해 정의되는 마이그레이션 관리자 계정에 할당할 사용 권한을 지정합니다. 미리 구성된 Exchange 마이그레이션 또는 단독형 Exchange 마이그레이션을 준비하면서 연결 설정을 테스트할 때나 Exchange 외부에서 Outlook 사용 마이그레이션 끝점을 만들 때 원본 메일 서버에서 사용자 사서함에 대한 연결을 테스트하기 위해 사용 권한을 할당합니다.

Credentials 매개 변수에 의해 정의된 계정에 대해 다음 값 중 하나를 지정합니다.

• FullAccess: 계정에 마이그레이션할 사서함에 Full-Access 권한이 할당됩니다.
• 관리: 계정은 마이그레이션할 사서함을 호스트하는 organization 도메인 관리자 그룹의 구성원입니다.

이 매개 변수는 원격 이동 마이그레이션 또는 IMAP 마이그레이션을 위한 원격 서버에 대한 연결을 테스트하는 데 사용되지 않습니다.

매개 변수 속성

매개 변수 집합

-Partition

적용 가능: Exchange Online

이 매개 변수는 클라우드 기반 서비스에서만 사용할 수 있습니다.

이 매개 변수는 Microsoft 내부에서 사용하도록 예약되어 있습니다.

매개 변수 속성

매개 변수 집합

-Port

적용 가능: Exchange Online

이 매개 변수는 클라우드 기반 서비스에서만 사용할 수 있습니다.

Port 매개 변수는 IMAP 마이그레이션 프로세스에서 대상 서버에 연결하는 데 사용하는 TCP 포트 번호를 지정합니다. 이 매개 변수는 IMAP 마이그레이션에만 필요합니다.

암호화되지 않은 연결의 경우 포트 143, TLS(전송 계층 보안)의 경우 포트 143, SSL(Secure Sockets Layer)의 경우 포트 993을 사용하는 것이 표준입니다.

매개 변수 속성

매개 변수 집합

-PSTImport

적용 가능: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

이 매개 변수는 온프레미스 Exchange에서만 사용 가능합니다.

이 매개 변수는 Microsoft 내부에서 사용하도록 예약되어 있습니다.

매개 변수 속성

매개 변수 집합

-PublicFolder

적용 가능: Exchange Online

이 매개 변수는 클라우드 기반 서비스에서만 사용할 수 있습니다.

이 매개 변수는 Microsoft 내부에서 사용하도록 예약되어 있습니다.

매개 변수 속성

매개 변수 집합

-PublicFolderDatabaseServerLegacyDN

적용 가능: Exchange Online

이 매개 변수는 클라우드 기반 서비스에서만 사용할 수 있습니다.

이 매개 변수는 Microsoft 내부에서 사용하도록 예약되어 있습니다.

매개 변수 속성

매개 변수 집합

-PublicFolderToUnifiedGroup

적용 가능: Exchange Server 2016, Exchange Server 2019, Exchange Online

PublicFolderToUnifiedGroup 스위치는 엔드포인트 유형이 Microsoft 365 그룹 공용 폴더임을 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

매개 변수 속성

매개 변수 집합

-RemoteServer

적용 가능: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

RemoteServer 매개 변수는 온-프레미스 메일 서버의 FQDN을 지정합니다. 이 매개 변수는 다음 마이그레이션 유형 중 하나를 수행하려는 경우 필요합니다.

• 포리스트 간 이동
• 원격 이동 (하이브리드 배포)
• IMAP 마이그레이션

매개 변수 속성

매개 변수 집합

-RPCProxyServer

적용 가능: Exchange Online

이 매개 변수는 클라우드 기반 서비스에서만 사용할 수 있습니다.

RPCProxyServer 매개 변수는 온-프레미스 Exchange 서버에 대한 RPC 프록시 서버의 FQDN을 지정합니다. Autodiscover 매개 변수를 사용하지 않는 경우 이 매개 변수가 필요합니다. 준비된 Exchange 마이그레이션 또는 단독형 Exchange 마이그레이션을 수행하여 사서함을 Exchange Online 마이그레이션하려는 경우 이 매개 변수를 사용합니다.

매개 변수 속성

매개 변수 집합

-Security

적용 가능: Exchange Online

이 매개 변수는 클라우드 기반 서비스에서만 사용할 수 있습니다.

IMAP 마이그레이션의 경우 Security 매개 변수는 원격 메일 서버에서 사용하는 암호화 방법을 지정합니다. 옵션은 None, Tls 또는 Ssl입니다.

매개 변수 속성

매개 변수 집합

-ServiceAccountKeyFileData

적용 가능: Exchange Online

이 매개 변수는 클라우드 기반 서비스에서만 사용할 수 있습니다.

ServiceAccountKeyFileData 매개 변수는 서비스 계정으로 인증하는 데 필요한 정보를 지정하는 데 사용됩니다. 데이터는 원격 테넌트 액세스 권한이 부여된 서비스 계정을 만들 때 다운로드되는 JSON 키 파일에서 가져옵니다.

이 매개 변수에 유효한 값을 사용하려면 다음 구문을 ([System.IO.File]::ReadAllBytes('<Path>\<FileName>'))사용하여 바이트 인코딩된 개체로 파일을 읽어야 합니다. 이 명령을 매개 변수 값으로 사용하거나 변수($data = [System.IO.File]::ReadAllBytes('<Path>\<FileName>'))에 출력을 쓰고 변수를 매개 변수 값($data)으로 사용할 수 있습니다.

매개 변수 속성

매개 변수 집합

-SourceMailboxLegacyDN

적용 가능: Exchange Online

이 매개 변수는 클라우드 기반 서비스에서만 사용할 수 있습니다.

SourceMailboxLegacyDN 매개 변수는 대상 서버에서 사서함을 지정합니다. 온-프레미스 테스트 사서함의 LegacyExchangeDN을 이 매개 변수 값으로 사용합니다. cmdlet은 대상 서버의 관리자 계정에 대한 자격 증명을 사용하여 이 사서함에 액세스하려고 시도합니다.

매개 변수 속성

매개 변수 집합

-TestMailbox

적용 가능: Exchange Online

이 매개 변수는 클라우드 기반 서비스에서만 사용할 수 있습니다.

TestMailbox 매개 변수는 대상 서버에서 사서함을 지정합니다. 이 매개 변수에 대한 값으로 기본 SMTP 주소를 사용합니다. cmdlet은 대상 서버의 관리자 계정에 대한 자격 증명을 사용하여 이 사서함에 액세스하려고 시도합니다.

매개 변수 속성

매개 변수 집합

-WhatIf

적용 가능: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

Whatif 스위치는 해당 명령의 동작을 시뮬레이션합니다. 이 스위치를 사용하면 변경 내용을 실제로 적용하지 않고 발생할 변경 내용을 확인할 수 있습니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

매개 변수 속성

매개 변수 집합

CommonParameters

입력

Input types

출력

Output types