Test-OwaConnectivity(RTM)
적용 대상: Exchange Server 2007
마지막으로 수정된 항목: 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>] [-DomainController <Fqdn>] [-MailboxServer <ServerIdParameter>] [-MonitoringContext <SwitchParameter>] [-ResetTestAccountCredentials <SwitchParameter>] [-TestType <Internal | External>] [-TrustAnySSLCertificate <SwitchParameter>] [-VirtualDirectoryName <String>]
Test-OwaConnectivity [-URL <String>] [-AllowUnsecureAccess <SwitchParameter>] [-DomainController <Fqdn>] [-MailboxCredential <PSCredential>] [-ResetTestAccountCredentials <SwitchParameter>] [-TrustAnySSLCertificate <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 매개 변수와 함께 사용하지 마십시오. |
DomainController |
선택 |
Microsoft.Exchange.Data.Fqdn |
Active Directory 디렉터리 서비스에서 데이터를 검색하는 도메인 컨트롤러의 FQDN(정규화된 도메인 이름)을 지정하려면 cmdlet에 DomainController 매개 변수를 포함시킵니다. |
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일마다 다시 설정됩니다. 이 플래그를 사용하면 보안상 이유로 필요할 때마다 암호를 강제로 다시 설정합니다. |
TestType |
선택 |
Microsoft.Exchange.Monitoring.OwaConnectivityTestType |
이 매개 변수는 cmdlet가 내부 URL을 테스트하는지 아니면 외부 URL을 테스트하는지 결정합니다. 사용할 수 있는 값은 Internal 및 External입니다. 이 매개 변수는 URL 매개 변수와 함께 사용할 수 없습니다. TestType 매개 변수와 URL 매개 변수를 모두 지정하지 않은 경우 기본값은 TestType:Internal입니다. |
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 가상 디렉터리가 테스트됩니다. |
입력 형식
반환 형식
오류
| 오류 | 설명 |
|---|---|
|
|
예외
| 예외 | 설명 |
|---|---|
|
|
예제
첫 번째 코드 예에서는 사용자 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