Test-ImapConnectivity
적용 대상: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
마지막으로 수정된 항목: 2010-08-18
Test-ImapConnectivity cmdlet를 사용하여 IMAP4 서비스가 예상대로 실행되는지 확인할 수 있습니다. 그리고 Test-ImapConnectivity cmdlet를 사용하여 동일한 Active Directory 사이트에 있는 Exchange 2007 서버의 모든 사서함에 대해 지정된 클라이언트 액세스 서버의 IMAP4 기능을 테스트할 수 있습니다.
구문
Test-ImapConnectivity [-ClientAccessServer <ServerIdParameter>] [-Confirm [<SwitchParameter>]] [-ConnectionType <Plaintext | Tls | Ssl>] [-DomainController <Fqdn>] [-LightMode <SwitchParameter>] [-MailboxCredential <PSCredential>] [-MailboxServer <ServerIdParameter>] [-MonitoringContext <SwitchParameter>] [-PerConnectionTimeout <Int32>] [-PortClientAccessServer <Int32>] [-ResetTestAccountCredentials <SwitchParameter>] [-Timeout <UInt32>] [-TrustAnySSLCertificate <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
자세한 정보
Test-ImapConnectivity cmdlet를 사용하여 IMAP4 서비스가 예상대로 실행되는지 확인할 수 있습니다. Test-ImapConnectivity cmdlet는 지정된 클라이언트 액세스 서버에 대한 IMAP4 기능 테스트에 사용할 수 있습니다.
Test-PopConnectivity cmdlet를 실행하여 클라이언트 액세스 서버의 IMAP4 기능을 테스트하려면, 사용하는 계정이 Exchange Server 관리자 역할 및 대상 서버에 대한 로컬 관리자 그룹의 구성원 자격을 위임받아야 합니다.
사용 권한, 역할 위임 및 Exchange Server 2007 관리에 필요한 권한에 대한 자세한 내용은 사용 권한 고려 사항을 참조하십시오.
매개 변수
| 매개 변수 | 필수 | 종류 | 설명 |
|---|---|---|---|
ClientAccessServer |
선택 |
Microsoft.Exchange.Configuration.Tasks.ServerIdParameter |
이 매개 변수는 테스트할 클라이언트 액세스 서버의 이름을 지정합니다. 이 매개 변수를 URL 매개 변수와 함께 사용하지 마십시오. |
Confirm |
선택 |
System.Management.Automation.SwitchParameter |
Confirm 매개 변수는 명령에서 처리 작업을 일시 중지하도록 하고 처리 작업을 계속하기 전 수행할 작업을 사용자가 확인하도록 합니다. Confirm 매개 변수에는 값을 지정할 필요가 없습니다. |
ConnectionType |
선택 |
Microsoft.Exchange.Monitoring.ProtocolConnectionType |
이 매개 변수는 클라이언트 액세스 서버 연결에 사용되는 연결 유형을 지정합니다. |
DomainController |
선택 |
Microsoft.Exchange.Data.Fqdn |
Active Directory 디렉터리 서비스에서 데이터를 검색하는 도메인 컨트롤러의 FQDN(정규화된 도메인 이름)을 지정하려면 cmdlet에 DomainController 매개 변수를 포함시킵니다. |
LightMode |
선택 |
System.Management.Automation.SwitchParameter |
이 매개 변수는 Test-ImapConnectivity cmdlet에 대해 구현되지 않습니다. 이 매개 변수를 사용해도 cmdlet 작업은 변경되지 않습니다. 참고 이 cmdlet는 다른 Exchange 2007 진단 cmdlet에 대해 구현되며 |
MailboxCredential |
선택 |
System.Management.Automation.PSCredential |
이 매개 변수는 단일 URL 테스트에 대한 사서함 자격 증명을 포함합니다. |
MailboxServer |
선택 |
Microsoft.Exchange.Configuration.Tasks.ServerIdParameter |
이 매개 변수는 테스트할 사서함 서버의 이름을 지정합니다. 이름을 지정하지 않는 경우 로컬 Active Directory 사이트의 모든 사서함 서버가 테스트됩니다. |
MonitoringContext |
선택 |
System.Management.Automation.SwitchParameter |
이 매개 변수가 포함되면 작업은 MOM(Microsoft Operations Manager) 예약에 의해 실행됩니다. MOM 없이 이 매개 변수를 사용하여 작업을 실행하면 작업이 실패합니다. 이 매개 변수를 제외하는 경우에는 관리자가 작업을 대화형으로 실행해야 합니다. |
PerConnectionTimeout |
선택 |
System.Int32 |
이 매개 변수는 연결당 테스트 작업이 완료될 때까지 기다리는 시간을 초로 지정합니다. PerConnectionTimeout의 기본값은 24초입니다. Timeout 값은 0초보다 크고 120초보다 작게 지정해야 합니다. 이 매개 변수 값을 항상 5초 이상으로 구성하는 것이 좋습니다. |
PortClientAccessServer |
선택 |
System.Int32 |
이 매개 변수는 Test-ImapConnectivity cmdlet와 함께 사용하는 클라이언트 액세스 서버에 연결하기 위해 사용할 포트를 지정합니다. |
ResetTestAccountCredentials |
선택 |
System.Management.Automation.SwitchParameter |
ResetTestAccountCredentials 매개 변수는 이 명령을 수행하는 데 사용되는 테스트 계정에 대한 암호를 다시 설정합니다. Microsoft System Center Operations Manager를 사용하여 Exchange 환경을 관리하는 경우 일반적으로 테스트 계정에 대한 암호는 7일마다 다시 설정됩니다. 이 플래그를 사용하면 보안상 이유로 필요할 때마다 암호를 강제로 다시 설정합니다. |
Timeout |
선택 |
System.UInt32 |
이 매개 변수는 테스트 작업이 완료될 때까지 기다리는 시간을 초로 지정합니다. Timeout의 기본값은 30초입니다. Timeout 값은 0초보다 크고 1시간(3600초)보다 작게 지정해야 합니다. 이 매개 변수 값을 항상 5초 이상으로 구성하는 것이 좋습니다. |
TrustAnySSLCertificate |
선택 |
System.Management.Automation.SwitchParameter |
이 매개 변수를 사용하는 경우 SSL(Secure Sockets Layer) 인증서 유효성 검사 실패가 보고되지 않습니다. 그리고 인증서가 클라이언트 액세스 서버의 URL과 일치하지 않을 때, 오류 없이 Test-ImapConnectivity cmdlet가 IMAP4 서비스를 검사할 수 있습니다. |
WhatIf |
선택 |
System.Management.Automation.SwitchParameter |
WhatIf 매개 변수는 명령 실행 시 개체에 대해 수행하게 되는 작업을 시뮬레이트하도록 지시합니다. WhatIf 매개 변수를 사용하면 사용자는 변경 내용을 실제로 적용하지 않고 어떠한 사항이 변경되는지 확인할 수 있습니다. WhatIf 매개 변수에는 값을 지정할 필요가 없습니다. |
입력 형식
반환 형식
오류
| 오류 | 설명 |
|---|---|
|
|
예제
첫 번째 코드 예제에서는 사용자 contoso\kweku의 자격 증명을 사용하여 클라이언트 액세스 서버 Contoso12에 대해 IMAP4 연결을 테스트합니다.
두 번째 코드 예제에서는 Contoso12라는 특정 클라이언트 액세스 서버의 IMAP4 연결을 테스트한 다음, 모든 Exchange 2007 사서함을 테스트합니다.
Test-ImapConnectivity -ClientAccessServer:Contoso12 -MailboxCredential:(get-credential contoso\kweku)
Test-ImapConnectivity -ClientAccessServer:Contoso12