Test-OwaConnectivity

  • 아티클

 

적용 대상: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

마지막으로 수정된 항목: 2010-08-18

Test-OwaConnectivity cmdlet를 사용하여 Microsoft Office Outlook Web Access이 예상대로 실행되는지 확인합니다. Test-OwaConnectivity cmdlet은 같은 Active Directory 사이트의 Exchange 2007 서버에 있는 모든 사서함의 지정된 클라이언트 액세스 서버의 모든 Microsoft Exchange 2007 가상 디렉터리에 대한 Outlook Web Access 연결을 테스트하는 데 사용할 수 있습니다. Test-OwaConnectivity를 사용하여 개별 Exchange 2007 Outlook Web Access URL의 연결을 테스트할 수도 있습니다.

구문

Test-OwaConnectivity [-ClientAccessServer <ServerIdParameter>] [-AllowUnsecureAccess <SwitchParameter>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-LightMode <SwitchParameter>] [-MailboxServer <ServerIdParameter>] [-MonitoringContext <SwitchParameter>] [-ResetTestAccountCredentials <SwitchParameter>] [-Site <AdSiteIdParameter>] [-TestType <Internal | External>] [-Timeout <UInt32>] [-TrustAnySSLCertificate <SwitchParameter>] [-VirtualDirectoryName <String>] [-WhatIf [<SwitchParameter>]]

Test-OwaConnectivity [-URL <String>] [-AllowUnsecureAccess <SwitchParameter>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-LightMode <SwitchParameter>] [-MailboxCredential <PSCredential>] [-ResetTestAccountCredentials <SwitchParameter>] [-Site <AdSiteIdParameter>] [-Timeout <UInt32>] [-TrustAnySSLCertificate <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

자세한 정보

Test-OwaConnectivity cmdlet를 사용하여 클라이언트 액세스 서버의 모든 Exchange 2007 Outlook Web Access 가상 디렉터리의 연결 또는 단일 Exchange 2007 Outlook Web Access URL의 연결을 테스트할 수 있습니다.

클라이언트 액세스 서버의 모든 Exchange 2007 Outlook Web Access 가상 디렉터리를 테스트하려면 테스트 Active Directory 계정이 있어야 합니다. 또한 사서함 서버 역할(테스트 중인 가상 디렉터리를 통해 액세스)이 설치된 각 Exchange 2007 서버에도 테스트 사서함이 있어야 합니다. 테스트 계정 및 테스트 사서함은 사서함 서버 설치 단계에서 만들 수 있습니다. 사서함 서버 설치 중에 테스트 환경을 만들지 않은 경우에는 Test-OwaConnectivity cmdlet를 실행할 때 테스트 사서함 및 테스트 사용자를 만드는 스크립트를 실행하라는 메시지가 표시됩니다.

테스트 사서함을 호스팅하는 서버를 사용할 수 없는 경우 Test-OWAConnectivity cmdlet가 문제를 명확하게 확인하지 않는 오류를 반환합니다. 이러한 현상이 발생하지 않도록 하려면 Test-OWAConnectivity cmdlet를 실행하기 전에 테스트 사서함을 호스팅하는 서버가 실행되고 있으며 해당 사서함을 사용할 수 있는지 확인합니다.

ClientAccessServer 매개 변수나 URL 매개 변수를 사용하지 않고 Test-OwaConnectivity cmdlet를 클라이언트 액세스 서버에서 실행하면 이 cmdlet를 실행하는 서버가 테스트됩니다. 특정 클라이언트 액세스 서버를 테스트하려면 ClientAccessServer 매개 변수를 사용합니다.

Test-OwaConnectivity cmdlet를 실행하여 클라이언트 액세스 서버의 모든 Exchange 2007 가상 디렉터리에 대해 Outlook Web Access 연결을 테스트하려면 사용하는 계정이 Exchange Server 관리자 역할 및 대상 서버의 로컬 관리자 그룹 구성원 자격을 위임받아야 합니다.

사용 권한, 역할 위임 및 Exchange Server 2007 관리에 필요한 권한에 대한 자세한 내용은 사용 권한 고려 사항을 참조하십시오.

단일 URL을 테스트하려면 URL 매개 변수와 기존 Exchange 2007 사서함에 대한 자격 증명을 사용하여 Test-OwaConnectivity를 실행합니다. URL이 부하 분산 장치 뒤에 있는 경우 cmdlet에서 테스트하는 클라이언트 액세스 서버를 예측할 수 없습니다. URL 매개 변수를 사용할 때 매개 변수의 일부로 자격 증명이 필요하기 때문에 URL 매개 변수를 사용하는 경우 Test-OwaConnectivity를 실행하기 위해 어떠한 계정이라도 사용할 수 있습니다.

SSL(Secure Sockets Layer)이 필요 없는 가상 디렉터리를 발견하면 cmdlet는 AllowUnsecureAccess 매개 변수를 사용하지 않는 한 해당 디렉터리를 건너뜁니다. AllowUnsecureAccess 매개 변수를 사용하는 경우 서버 간의 통신이 테스트를 위해 암호화되지 않은 텍스트로 전송됩니다.

Test-OwaConnectivity cmdlet는 일회성 대화형 작업 또는 MOM(Microsoft Operations Manager)이 제어하는 예정된 작업으로 실행할 수 있습니다. Test-OwaConnectivity를 MOM 작업으로 실행하려면 cmdlet이 테스트할 사서함 서버에서 클라이언트 액세스 테스트 환경을 사용할 수 있어야 합니다.

매개 변수

매개 변수 필수 종류 설명

AllowUnsecureAccess

선택

System.Management.Automation.SwitchParameter

이 매개 변수를 포함하는 경우 SSL이 필요 없는 가상 디렉터리를 테스트할 수 있습니다. 포함하지 않는 경우 SSL이 필요 없는 가상 디렉터리에 대해 작업을 건너뛰고 오류가 생성됩니다.

ClientAccessServer

선택

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

이 매개 변수는 테스트할 클라이언트 액세스 서버의 이름을 지정합니다. 이 매개 변수를 포함하는 경우 클라이언트 액세스 서버의 모든 Exchange 2007 Outlook Web Access 가상 디렉터리가 로컬 Active Directory 사이트의 모든 Exchange 2007 사서함 서버에 대해 테스트됩니다. Microsoft Exchange 2000 Server 및 Microsoft Exchange Server 2003 가상 디렉터리는 테스트되지 않습니다. Exchange 2007 사서함 서버에 없는 사서함도 테스트되지 않습니다. 이 매개 변수를 URL 매개 변수와 함께 사용하지 마십시오.

Confirm

선택

System.Management.Automation.SwitchParameter

Confirm 매개 변수는 명령에서 처리 작업을 일시 중지하도록 하고 처리 작업을 계속하기 전 수행할 작업을 사용자가 확인하도록 합니다. Confirm 매개 변수에는 값을 지정할 필요가 없습니다.

DomainController

선택

Microsoft.Exchange.Data.Fqdn

Active Directory 디렉터리 서비스에서 데이터를 검색하는 도메인 컨트롤러의 FQDN(정규화된 도메인 이름)을 지정하려면 cmdlet에 DomainController 매개 변수를 포함시킵니다.

LightMode

선택

System.Management.Automation.SwitchParameter

이 매개 변수는 Test-OwaConnectivity 진단 cmdlet에 대해 구현되지 않습니다. 이 매개 변수를 사용해도 cmdlet 동작은 변경되지 않습니다.

참고

이 cmdlet는 다른 Exchange 2007 진단 cmdlet에 대해 구현되며 특히 그다지 집중적이지 않은 cmdlet 버전을 실행하려는 경우에 사용됩니다.

MailboxCredential

선택

System.Management.Automation.PSCredential

이 매개 변수는 단일 URL 테스트에 대한 사서함 자격 증명을 포함합니다.

MailboxServer

선택

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

이 매개 변수는 테스트할 사서함 서버의 이름을 지정합니다. 이름을 지정하지 않는 경우 로컬 Active Directory 사이트의 모든 사서함 서버가 테스트됩니다.

MonitoringContext

선택

System.Management.Automation.SwitchParameter

이 매개 변수를 포함하는 경우 MOM 일정에 의해 작업이 실행됩니다. MOM 없이 이 매개 변수를 사용하여 작업을 실행하면 작업이 실패합니다. 이 매개 변수를 제외하는 경우에는 관리자가 작업을 대화형으로 실행해야 합니다.

ResetTestAccountCredentials

선택

System.Management.Automation.SwitchParameter

ResetTestAccountCredentials 매개 변수는 이 명령을 수행하는 데 사용되는 테스트 계정에 대한 암호를 다시 설정합니다. Microsoft System Center Operations Manager를 사용하여 Exchange 환경을 관리하는 경우 일반적으로 테스트 계정에 대한 암호는 7일마다 다시 설정됩니다. 이 플래그를 사용하면 보안상 이유로 필요할 때마다 암호를 강제로 다시 설정합니다.

Site

선택

Microsoft.Exchange.Configuration.Tasks.AdSiteIdParameter

Site 매개 변수는 Active Directory 사이트를 지정하는 데 사용됩니다.

TestType

선택

Microsoft.Exchange.Monitoring.OwaConnectivityTestType

이 매개 변수는 cmdlet가 내부 URL을 테스트하는지 아니면 외부 URL을 테스트하는지 결정합니다. 사용할 수 있는 값은 Internal 및 External입니다. 이 매개 변수는 URL 매개 변수와 함께 사용할 수 없습니다. TestType 매개 변수와 URL 매개 변수를 모두 지정하지 않은 경우 기본값은 TestType:Internal입니다.

Timeout

선택

System.UInt32

이 매개 변수는 테스트 작업이 완료될 때까지 기다리는 시간(초)을 지정합니다. Timeout의 기본값은 30초입니다. Timeout 값은 0초보다 크고 1시간(3600초)보다 작게 지정해야 합니다. 이 매개 변수 값을 항상 5초 이상으로 구성하는 것이 좋습니다.

TrustAnySSLCertificate

선택

System.Management.Automation.SwitchParameter

이 매개 변수를 사용하는 경우 SSL 인증서 유효성 검사 실패가 보고되지 않습니다. IIS(인터넷 정보 서비스)에서는 단일 가상 디렉터리에 대해 여러 인증서를 할당할 수 없으므로 이 매개 변수는 내부 URL을 테스트하는 경우 유용합니다. 디렉터리가 내부 및 외부 액세스를 위해 서로 다른 URL을 가지고 인증서가 있는 경우 해당 인증서는 일반적으로 외부 URL에 대해 유효합니다. 이 매개 변수를 통해 인증서가 URL과 일치하지 않은 경우 오류 생성 없이 내부 URL을 검사합니다.

URL

선택

System.String

이 매개 변수는 테스트할 Outlook Web Access URL을 지정합니다. 이 매개 변수를 사용하는 경우 지정된 URL만 테스트됩니다. URL 매개 변수를 ClientAccessServer 매개 변수와 함께 사용하지 마십시오. 또한 URL 매개 변수는 TestType 매개 변수와 함께 사용할 수 없습니다.

VirtualDirectoryName

선택

System.String

이 매개 변수는 특정 클라이언트 액세스 서버에서 테스트할 가상 디렉터리의 이름을 지정합니다. 이 매개 변수를 포함하지 않는 경우 Exchange 2007 사서함을 지원하는 모든 Outlook Web Access 가상 디렉터리가 테스트됩니다.

WhatIf

선택

System.Management.Automation.SwitchParameter

WhatIf 매개 변수는 명령 실행 시 개체에 대해 수행하게 되는 작업을 시뮬레이트하도록 지시합니다. WhatIf 매개 변수를 사용하면 사용자는 변경 내용을 실제로 적용하지 않고 어떠한 사항이 변경되는지 확인할 수 있습니다. WhatIf 매개 변수의 값을 지정할 필요가 없습니다.

입력 형식

반환 형식

오류

오류 설명

 

 

예외

예외 설명

 

 

예제

첫 번째 코드 예에서는 사용자 contoso\kweku의 자격 증명을 사용하여 URL https://mail.contoso.com/owa에 대한 연결을 테스트합니다.

두 번째 코드 예에서는 이름이 Contoso12인 특정 클라이언트 액세스 서버의 연결을 테스트한 다음 Exchange 2007 사서함을 지원하는 모든 Outlook Web Access 가상 디렉터리를 테스트합니다. 여기에는 SSL이 필요 없는 가상 디렉터리가 포함됩니다.

Test-OwaConnectivity -URL:https://mail.contoso.com/owa -MailboxCredential:(get-credential contoso\kweku)
Test-OwaConnectivity -ClientAccessServer:Contoso12 -AllowUnsecureAccess