Test-ActiveSyncConnectivity

 

적용 대상:Exchange Server 2016

마지막으로 수정된 항목:2016-04-06

이 cmdlet은 온-프레미스 Exchange Server 2016에서만 제공됩니다.

Test-ActiveSyncConnectivity cmdlet을 사용하여 MicrosoftExchange ActiveSync 가상 디렉터리에 대한 연결을 테스트할 수 있습니다.

아래 구문 섹션에 있는 매개 변수 집합에 대한 자세한 내용은 Exchange cmdlet 구문을 참조하세요.

Test-ActiveSyncConnectivity [-AllowUnsecureAccess <SwitchParameter>] [-ClientAccessServer <ServerIdParameter>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-LightMode <SwitchParameter>] [-MailboxCredential <PSCredential>] [-MailboxServer <ServerIdParameter>] [-MonitoringContext <SwitchParameter>] [-MonitoringInstance <String>] [-ResetTestAccountCredentials <SwitchParameter>] [-Timeout <UInt32>] [-TrustAnySSLCertificate <SwitchParameter>] [-URL <String>] [-UseAutodiscoverForClientAccessServer <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

이 예에서는 MBX01 서버에 대한 Exchange ActiveSync 클라이언트 연결을 테스트합니다.

Test-ActiveSyncConnectivity -ClientAccessServer MBX01

이 예에서는 자동 검색 URL을 사용하여 PaulS 사서함에 대한 Exchange ActiveSync 연결을 테스트합니다.

Test-ActiveSyncConnectivity -UseAutodiscoverForClientAccessServer $true -URL "http://contoso.com/mail" -MailboxCredential (Get-Credential pauls@contoso.com)

Test-ActiveSyncConnectivity cmdlet은 지정된 Exchange ActiveSync 가상 디렉터리, 지정된 Exchange 서버에 있는 임의의 Exchange ActiveSync 가상 디렉터리 또는 로컬 Active Directory 사이트에서 사용 가능한 임의의 Exchange ActiveSync 가상 디렉터리에 연결하여 Exchange ActiveSync 연결을 테스트합니다.

이 cmdlet을 처음 사용할 때는 테스트 사용자를 만들어야 할 수도 있습니다. 테스트 사용자를 만들려면 다음 명령을 실행합니다.

& $env:ExchangeInstallPath\Scripts\New-TestCasConnectivityUser.ps1

테스트 결과가 화면에 표시됩니다. 이 cmdlet은 다음 정보를 반환합니다.

  • CasServer   클라이언트가 연결한 Exchange 서버입니다.

  • LocalSite   로컬 Active Directory 사이트의 이름입니다.

  • Scenario   테스트한 작업입니다. 값은 Options, FolderSync, First Sync, GetItemEstimate, Sync Data, PingSync Test Item입니다.

  • Result   반환되는 결과는 보통 Success, Skipped 또는 Failure입니다.

  • Latency(MS)   테스트를 완료하는 데 필요한 시간(밀리초)입니다.

  • Error   발생한 오류 메시지입니다.

출력을 ConvertTo-Html 또는 ConvertTo-Csv로 파이프 처리하고 명령에 > <filename>을 추가하여 파일에 결과를 쓸 수 있습니다. 예:

Test-ActiveSyncConnectivity -ClientAccessServer MBX01 | ConvertTo-Html > "C:\My Documents\EAS Test.html"

클라이언트 및 모바일 장치 사용 권한 항목의 이 cmdlet을 실행하려면 먼저 사용 권한을 할당받아야 합니다. 이 cmdlet의 모든 매개 변수가 이 항목에 나열되지만 사용자에게 할당된 사용 권한에 포함되지 않은 일부 매개 변수에는 액세스할 수 없습니다. 필요한 사용 권한을 확인하려면 다음을 참조하세요. "Exchange ActiveSync 서버 설정" 항목.

 

매개 변수 필수 종류 설명

AllowUnsecureAccess

선택

System.Management.Automation.SwitchParameter

AllowUnsecureAccess 스위치를 사용하면 SSL(Secure Sockets Layer)이 필요 없는 보안되지 않은 채널에 대해 테스트를 계속할 수 있습니다. 이 스위치를 사용하여 값을 지정할 필요가 없습니다.

ClientAccessServer

선택

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

ClientAccessServer 매개 변수는 테스트할 Exchange 서버를 지정합니다. 이 서버에는 클라이언트 액세스 서버 역할이 설치되어 있으며 클라이언트 연결을 수락하는 일을 담당합니다.

서버를 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예를 들면 다음과 같습니다.

  • 이름

  • DN(고유 이름)

  • ExchangeLegacyDN

  • GUID

Url 매개 변수와 함께 이 매개 변수를 사용할 수는 없습니다.

Confirm

선택

System.Management.Automation.SwitchParameter

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

  • 파괴적인 cmdlet(예: Remove-* cmdlet)에는 계속하기 전에 명령을 강제로 승인하도록 하는 일시 중지 기능이 기본 제공되어 있습니다. 이러한 cmdlet의 경우 정확한 구문 -Confirm:$false를 사용하여 확인 메시지를 건너뛸 수 있습니다.

  • 대부분의 다른 cmdlet(예: New-*Set-* cmdlet)에는 일시 중지 기능이 기본 제공되어 있지 않습니다. 이러한 cmdlet의 경우 값 없이 Confirm 스위치를 지정하면 계속하기 전에 명령을 강제로 확인하도록 하는 일시 중지가 추가됩니다.

DomainController

선택

Microsoft.Exchange.Data.Fqdn

DomainController 매개 변수는 Active Directory에서 데이터를 읽거나 데이터를 쓰기 위해 이 cmdlet이 사용하는 도메인 컨트롤러를 지정합니다. FQDN(정규화 된 도메인 이름)으로 도메인 컨트롤러를 식별합니다. 예: dc01.contoso.com

LightMode

선택

System.Management.Automation.SwitchParameter

LightMode 스위치는 명령에서 테스트 중 일부만 수행하도록 지시합니다. 이 스위치를 사용하여 값을 지정할 필요가 없습니다.

이 스위치를 사용할 때는 Options 테스트만 실행됩니다.

이 스위치를 사용하지 않으면 First Sync, GetItemEstimate, Sync Data, PingSync Test Item 테스트도 실행됩니다.

MailboxCredential

선택

System.Management.Automation.PSCredential

MailboxCredential 매개 변수는 하나의 사서함 테스트에 사용할 사서함 자격 증명을 지정합니다.

이 매개 변수를 지정하면 Get-Credential cmdlet을 사용하여 자격 증명 개체를 만들어야 합니다. 자세한 내용은 Get-Credential을 참조하세요.

MailboxServer

선택

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

MailboxServer 매개 변수는 테스트할 Exchange 2016 또는 Exchange 2013 사서함 서버를 지정합니다. 이 매개 변수는 클라이언트가 연결하는 프런트 엔드 서버에서 프록시된 연결을 허용하는 백 엔드 서버를 식별합니다.

서버를 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예를 들면 다음과 같습니다.

  • 이름

  • DN(고유 이름)

  • ExchangeLegacyDN

  • GUID

이 매개 변수를 사용하지 않으면 로컬 Active Directory 사이트에 있는 모든 사서함 서버에 대한 연결이 테스트됩니다.

MonitoringContext

선택

System.Management.Automation.SwitchParameter

MonitoringContext 스위치는 결과에 관련 모니터링 이벤트와 성능 카운터를 포함합니다. 일반적으로 출력이 SCOM(MicrosoftSystem Center Operations Manager)에 전달될 때 모니터링 이벤트 및 성능 카운터를 결과에 포함합니다. 이 스위치를 사용하여 값을 지정할 필요가 없습니다.

MonitoringInstance

선택

System.String

MonitoringInstance 매개 변수는 Microsoft SCOM(System Center Operations Manager)에서 테스트를 실행할 때 이 작업에 대한 식별자를 지정합니다. SCOM은 같은 서버에서 동시에 여러 테스트 인스턴스를 실행할 수 있으므로 이 매개 변수는 중요합니다.

ResetTestAccountCredentials

선택

System.Management.Automation.SwitchParameter

ResetTestAccountCredentials 스위치는 이 명령을 실행하는 데 사용되는 테스트 계정의 암호를 다시 설정합니다. 테스트 계정의 암호는 일반적으로 7일마다 다시 설정됩니다. 보안상의 이유로 암호를 다시 설정해야 할 때는 이 스위치를 사용하여 강제로 암호를 다시 설정하세요.

Timeout

선택

System.UInt32

Timeout 매개 변수는 명령에서 응답할 때까지 기다리는 시간(초)을 지정합니다.

TrustAnySSLCertificate

선택

System.Management.Automation.SwitchParameter

TrustAnySSLCertificate 스위치는 SSL(Secure Sockets Layer) 인증서 유효성 검사 오류를 무시할지 여부를 지정합니다. 이 스위치를 사용하여 값을 지정할 필요가 없습니다.

연결된 인증서가 있는 URL은 일반적으로 외부 URL이므로 이 스위치는 내부 URL을 테스트하는 데 유용합니다. 이 스위치를 통해 인증서가 URL과 일치하지 않은 경우 오류 생성 없이 내부 URL을 검사합니다.

URL

선택

System.String

URL 매개 변수는 Exchange ActiveSync 가상 디렉터리에 연결하는 데 사용되는 URL을 지정합니다.

ClientAccessServer 매개 변수와 함께 이 매개 변수를 사용할 수는 없습니다.

UseAutodiscoverForClientAccessServer

선택

System.Management.Automation.SwitchParameter

UseAutodiscoverForClientAccessServer 스위치는 테스트에서 자동 검색 서비스를 사용하여 Exchange ActiveSync 가상 디렉터리를 찾을지 여부를 지정합니다. 이 스위치를 사용하여 값을 지정할 필요가 없습니다.

WhatIf

선택

System.Management.Automation.SwitchParameter

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

이 cmdlet이 수락하는 입력 형식을 보려면 Cmdlet 입출력 형식을 참조하세요. cmdlet의 입력 형식 필드가 비어 있을 경우 cmdlet은 입력 데이터를 수락하지 않습니다.

이 cmdlet이 수락하는 반환 형식(출력 형식이라고도 함)을 보려면 Cmdlet 입출력 형식을 참조하세요. 출력 형식 필드가 비어 있는 경우 cmdlet은 데이터를 반환하지 않습니다.

 
표시: