Test-WebServicesConnectivity

 

적용 대상:Exchange Server 2016

마지막으로 수정된 항목:2016-03-31

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

Test-WebServicesConnectivity cmdlet을 사용하여 Exchange Web Services 가상 디렉터리에 대한 클라이언트 연결을 테스트할 수 있습니다.

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

Test-WebServicesConnectivity -MonitoringContext <SwitchParameter> <COMMON PARAMETERS>
Test-WebServicesConnectivity [-ClientAccessServer <ClientAccessServerIdParameter>] <COMMON PARAMETERS>
Test-WebServicesConnectivity -AutoDiscoverServer <ClientAccessServerIdParameter> <COMMON PARAMETERS>
COMMON PARAMETERS: [-Confirm [<SwitchParameter>]] [-Identity <MailboxIdParameter>] [-LightMode <SwitchParameter>] [-MailboxCredential <PSCredential>] [-TrustAnySSLCertificate <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

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

Test-WebServicesConnectivity -ClientAccessServer MBX01

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

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

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

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

  • Source   원본 서버입니다.

  • ServiceEndpoint   대상 서버입니다.

  • Scenario   테스트한 작업입니다. 값은 Autodiscover: SOAP ProviderEWS: GetFolder(전체 모드) 또는 EWS: ConvertID(라이트 모드)입니다.

  • Result   반환되는 값은 일반적으로 Success 또는 *FAILURE*입니다.

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

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

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

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

 

매개 변수 필수 종류 설명

AutoDiscoverServer

필수

Microsoft.Exchange.Configuration.Tasks.ClientAccessServerIdParameter

AutoDiscoverServer 매개 변수는 자동 검색에 사용되는 클라이언트 액세스 서버 역할이 설치된 서버를 지정합니다.

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

  • 이름

    예제: Exchange01

  • DN(고유 이름)

    예: CN=Exchange01,CN=Servers,CN=Exchange Administrative Group (FYDIBOHF23SPDLT),CN=Administrative Groups,CN=First Organization,CN=Microsoft Exchange,CN=Services,CN=Configuration,DC=contoso,DC=com

  • Exchange 레거시 DN

    예: /o=First Organization/ou=Exchange Administrative Group (FYDIBOHF23SPDLT)/cn=Configuration/cn=Servers/cn=Exchange01

  • GUID

    예제: bc014a0d-1509-4ecc-b569-f077eec54942

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

MonitoringContext

필수

System.Management.Automation.SwitchParameter

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

ClientAccessServer

선택 사항

Microsoft.Exchange.Configuration.Tasks.ClientAccessServerIdParameter

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

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

  • 이름

  • DN(고유 이름)

  • ExchangeLegacyDN

  • GUID

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

Confirm

선택

System.Management.Automation.SwitchParameter

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

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

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

Identity

옵션

Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter

Identity 매개 변수는 테스트에 사용할 사서함을 지정합니다. 사서함을 고유하게 식별하는 모든 값을 사용할 수 있습니다.

예를 들면 다음과 같습니다.

  • 이름

  • 표시 이름

  • 별칭

  • DN(고유 이름)

  • 정식 DN

  • <domain name>\<account name>

  • 전자 메일 주소

  • GUID

  • LegacyExchangeDN

  • SamAccountName

  • 사용자 ID 또는 UPN(사용자 계정 이름)

이 매개 변수를 사용하는 경우 MailboxCredential 매개 변수도 사용해야 합니다.

LightMode

선택

System.Management.Automation.SwitchParameter

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

이 스위치를 사용하는 경우 EWS: GetFolder 테스트 대신 EWS: ConvertId 테스트를 실행합니다.

MailboxCredential

선택

System.Management.Automation.PSCredential

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

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

이 매개 변수는 Identity 매개 변수를 사용하는 경우 필요합니다.

TrustAnySSLCertificate

선택

System.Management.Automation.SwitchParameter

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

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

WhatIf

선택

System.Management.Automation.SwitchParameter

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

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

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

 
표시: