Test-MapiConnectivity

  • 아티클

 

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

마지막으로 수정된 항목: 2007-07-05

Test-MapiConnectivity cmdlet를 사용하여 지정한 사서함에 로그온하여 서버 기능을 확인합니다. 사서함을 지정하지 않은 경우 cmdlet는 지정한 데이터베이스의 SystemMailbox에 로그온합니다.

구문

Test-MAPIConnectivity [-ActiveDirectoryTimeout <Int32>] [-AllConnectionsTimeout <Int32>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-MonitoringContext <$true | $false>] [-PerConnectionTimeout <Int32>] [-Server <ServerIdParameter>] [-WhatIf [<SwitchParameter>]]

Test-MAPIConnectivity -Database <DatabaseIdParameter> [-ActiveDirectoryTimeout <Int32>] [-AllConnectionsTimeout <Int32>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-MonitoringContext <$true | $false>] [-PerConnectionTimeout <Int32>] [-WhatIf [<SwitchParameter>]]

Test-MAPIConnectivity -Identity <MailboxIdParameter> [-ActiveDirectoryTimeout <Int32>] [-AllConnectionsTimeout <Int32>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-MonitoringContext <$true | $false>] [-PerConnectionTimeout <Int32>] [-WhatIf [<SwitchParameter>]]

자세한 설명

Test-MapiConnectivity cmdlet를 실행하려면 사용하는 계정이 다음을 위임받아야 합니다.

  • 대상 서버에 대한 Exchange Server 관리자 역할 및 로컬 관리자 그룹

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

Test-MapiConnectivity cmdlet를 사용하여 서버 기능을 확인합니다. 이 cmdlet는 지정한 사서함에 로그온하거나 Identity 매개 변수를 지정하지 않은 경우에는 SystemMailbox에 로그온하여 받은 편지함의 항목 목록을 검색합니다. 사서함에 로그온하면 클라이언트가 사서함 서버에 연결할 때 사용되는 두 가지 중요한 프로토콜인 MAPI와 LDAP를 테스트합니다. 인증하는 동안 Test-MapiConnectivity cmdlet에서 MAPI 서버, Exchange 저장소 및 DSAccess(디렉터리 서비스 액세스)가 작동하고 있는지 간접적으로 확인합니다.

cmdlet는 로컬 컴퓨터에 로그온 시 사용하는 계정의 자격 증명을 사용하여 지정한 사서함에 로그온합니다. 인증이 완료된 후 Test-MapiConnectivity cmdlet가 사서함에 액세스하여 데이터베이스가 작동하고 있는지 확인합니다. 사서함에 연결되면 cmdlet는 로그온 시도가 발생한 시간도 확인합니다.

이 명령에 사용할 수 있는 세 개의 고유 매개 변수는 Database, Identity 및 Server입니다.

  • Database 매개 변수는 데이터베이스 ID로 지정된 데이터베이스의 시스템 사서함에 로그온할 수 있는지 테스트합니다.

  • Identity 매개 변수는 사서함 ID로 특정 사서함에 로그온할 수 있는지 테스트합니다.

  • Server 매개 변수는 서버 ID로 지정된 서버에서 각 시스템 사서함에 로그온할 수 있는지 테스트합니다.

매개 변수

매개 변수 필수 종류 설명

Database

필수

Microsoft.Exchange.Configuration.Tasks.DatabaseIdParameter

Database 매개 변수는 시스템 사서함에 대한 연결을 테스트할 데이터베이스를 지정합니다. 이 매개 변수 또는 Identity 매개 변수를 지정하지 않은 경우 명령은 지정한 서버에 있는 각 데이터베이스의 SystemMailbox를 테스트하거나 Server 매개 변수를 지정하지 않은 경우에는 로컬 서버의 SystemMailbox를 테스트합니다.

Identity

필수

Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter

Identity 매개 변수는 테스트할 사서함을 지정합니다. 다음 값을 사용할 수 있습니다.

  • GUID

  • DN(고유 이름)

  • 도메인\계정

  • UPN(사용자 이름)

  • 레거시 Exchange DN

  • SMTP(Simple Mail Transfer Protocol) 주소

  • 별칭

  • 이 매개 변수는 Get-Mailbox 또는 Get-Recipient cmdlet로부터 파이프라인 입력을 받아들입니다. 개체가 Get-Mailbox cmdlet 또는 Get-Recipient cmdlet로부터 파이프된 경우에는 이 매개 변수가 필요하지 않습니다.

  • 이 매개 변수를 지정하지 않은 경우 cmdlet는 지정한 데이터베이스의 SystemMailbox를 테스트합니다.

ActiveDirectoryTimeout

선택

System.Int32

ActiveDirectoryTimeout 매개 변수는 작업 시간이 종료되기 전 각 Active Directory 작업을 완료하는 데 허용되는 시간(초)을 지정합니다. 기본값은 15초입니다.

AllConnectionsTimeout

선택

System.Int32

모든 ConnectionTimeout 매개 변수는 cmdlet 시간이 종료되기 전 모든 연결을 완료하는 데 허용되는 시간(초)을 지정합니다. Active Directory에서 연결하는 데 필요한 모든 정보를 수집해야 시간 제한 카운트다운이 시작됩니다. 기본 값은 90초입니다.

Confirm

선택

System.Management.Automation.SwitchParameter

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

DomainController

선택

Microsoft.Exchange.Data.Fqdn

DomainController 매개 변수는 Active Directory 디렉터리 서비스에 액세스하는 데 사용할 도메인 컨트롤러를 지정합니다. 사용하려는 도메인 컨트롤러의 FQDN(정규화된 도메인 이름)을 사용하십시오.

MonitoringContext

선택

System.Boolean

MonitoringContext 매개 변수는 명령의 결과에 모니터링 이벤트 및 성능 카운터를 포함할 것인지 여부를 지정합니다. 이 매개 변수에 사용할 수 있는 두 가지 값은 $true 또는 $false입니다. $true를 지정하는 경우 결과에 MAPI 트랜잭션 정보와 함께 모니터링 이벤트 및 성능 카운터가 포함됩니다.

PerConnectionTimeout

선택

System.Int32

PerConnectionTimeout 매개 변수는 연결 시간이 종료되기 전 각 연결을 완료하는 데 허용되는 시간(초)을 지정합니다. 기본값은 10초입니다.

Server

선택

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

Server 매개 변수는 MAPI 연결을 테스트할 서버를 지정합니다. 해당 명령은 지정된 서버에서 각 시스템 사서함에 대한 MAPI 연결을 테스트합니다.

이 매개 변수를 지정하지 않으면 명령은 로컬 서버의 사서함을 테스트합니다.

WhatIf

선택

System.Management.Automation.SwitchParameter

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

입력 형식

반환 형식

오류

오류 설명

 

예외

예외 설명

 

예제

첫 번째 예에서는 서버 Server01에 대한 연결을 테스트합니다.

두 번째 예에서는 도메인 이름 및 사용자 이름으로 지정된 사서함에 대한 연결을 테스트합니다.

Test-MapiConnectivity -Server "Server01"
Test-MapiConnectivity -Identity "midwest\john"