Test-OwaConnectivity

참조

모듈:: ExchangePowerShell

적용 대상:: Exchange Server 2010

이 cmdlet은 Exchange Server 2010년에만 사용할 수 있습니다.

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

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

Syntax

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

Test-OwaConnectivity
    [[-ClientAccessServer] <ServerIdParameter>]
    [-MailboxServer <ServerIdParameter>]
    [-MonitoringContext]
    [-RSTEndpoint <String>]
    [-TestType <OwaConnectivityTestType>]
    [-VirtualDirectoryName <String>]
    [-AllowUnsecureAccess]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-LightMode]
    [-ResetTestAccountCredentials]
    [-Timeout <UInt32>]
    [-TrustAnySSLCertificate]
    [-WhatIf]
    [<CommonParameters>]

Description

Test-OwaConnectivity cmdlet은 클라이언트 액세스 서버에서 모든 Exchange Outlook Web App 가상 디렉터리의 연결을 테스트하거나 단일 Exchange Outlook Web App URL의 연결을 테스트합니다.

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

테스트 사서함을 호스트하는 서버를 사용할 수 없는 경우 Test-OwaConnectivity cmdlet은 문제를 명확하게 식별하지 못할 수 있는 오류를 반환합니다. 이를 방지하려면 테스트 사서함을 호스트하는 서버가 실행 중이고 Test-OwaConnectivity cmdlet을 실행하기 전에 사서함을 사용할 수 있는지 확인합니다. Test-MapiConnectivity cmdlet을 사용하여 이 작업을 수행할 수 있습니다.

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

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

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

Test-OwaConnectivity cmdlet은 일회성 대화형 작업 또는 Microsoft System Center Operations Manager 2007 컨트롤에서 예약된 작업으로 실행할 수 있습니다. Test-OwaConnectivity cmdlet을 System Center Operations Manager 2007 작업으로 실행하려면 cmdlet이 테스트하는 사서함 서버에서 클라이언트 액세스 테스트 사서함을 사용할 수 있어야 합니다.

이 cmdlet을 실행하려면 먼저 사용 권한을 할당받아야 합니다. 이 항목에는 해당 cmdlet의 모든 매개 변수가 나열되지만 사용자에게 할당된 사용 권한에 포함되지 않은 일부 매개 변수에는 액세스할 수 없습니다. 조직에서 cmdlet 또는 매개 변수를 실행하는 데 필요한 사용 권한을 확인하려면 Find the permissions required to run any Exchange cmdlet를 참조하세요.

예제

예 1

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

다음은 contoso\kweku 사용자에 대한 자격 증명을 사용하여 URL https://mail.contoso.com/owa 에 대한 연결을 테스트하는 예제입니다.

예 2

Test-OwaConnectivity -ClientAccessServer:Contoso12 -AllowUnsecureAccess

이 예제에서는 특정 클라이언트 액세스 서버 Contoso12의 연결을 테스트하고 Exchange 사서함을 지원하는 모든 Exchange Outlook Web App 가상 디렉터리를 테스트합니다. 여기에는 SSL이 필요하지 않은 가상 디렉터리도 포함됩니다.

매개 변수

-AllowUnsecureAccess

AllowUnsecureAccess 스위치는 SSL이 필요하지 않은 가상 디렉터리를 테스트할지 여부를 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

이 스위치를 사용하지 않으면 명령은 SSL이 필요하지 않은 가상 디렉터리를 건너뛰고 오류가 생성됩니다.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-ClientAccessServer

이 매개 변수는 Exchange Server 2010에서만 사용할 수 있습니다.

ClientAccessServer 매개 변수는 테스트할 클라이언트 액세스 서버의 이름을 지정합니다. 이 매개 변수가 포함된 경우 클라이언트 액세스 서버의 모든 Exchange Outlook Web App 가상 디렉터리가 로컬 Active Directory 사이트의 모든 Exchange 사서함 서버에 대해 테스트됩니다.

URL 매개 변수와 함께 이 매개 변수를 사용하지 마세요.

Type:	ServerIdParameter
Position:	1
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-Confirm

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

파괴적인 cmdlet(예: Remove-* cmdlet)에는 계속하기 전에 명령을 강제로 승인하도록 하는 기본 제공 일시 중지가 있습니다. 이러한 cmdlet의 경우 정확한 구문 -Confirm:$false를 사용하여 확인 메시지를 건너뛸 수 있습니다.
대부분의 다른 cmdlet(예: New-* 및 Set-* cmdlet)에는 기본 제공 일시 중지가 없습니다. 이러한 cmdlet의 경우 값 없이 스위치를 지정하면 계속하기 전에 명령을 강제로 확인하도록 하는 일시 중지가 추가됩니다.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-DomainController

DomainController 매개 변수는 Active Directory에서 데이터를 읽거나 쓰기 위해 이 cmdlet이 사용하는 도메인 컨트롤러를 지정합니다. FQDN(정규화된 도메인 이름)으로 도메인 컨트롤러를 식별합니다. 예: dc01.contoso.com

Type:	Fqdn
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-LightMode

LightMode 매개 변수는 이 진단 명령에 대해 구현되지 않습니다. 이 매개 변수를 사용하면 명령의 동작이 변경되지 않습니다.

이 매개 변수는 덜 집약적인 버전의 명령을 실행하는 데 사용되는 다른 Exchange 진단 명령에 대해 구현됩니다.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-MailboxCredential

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

이 매개 변수의 값에는 Get-Credential cmdlet이 있어야 합니다. 이 명령을 일시 중지 하고 자격 증명을 입력 하라는 메시지가 표시 되면 (Get-Credential)값을 사용 합니다. 또는이 명령을 실행 하기 전에 자격 증명을 변수에 저장 (예: $cred = Get-Credential) 한 다음이 매개 변수에 대 한 변수 이름 ($cred)을 사용 합니다. 자세한 내용은 Get-Credential을 참조하세요.

MailboxCredential 매개 변수는 URL 매개 변수를 사용하는 경우에만 필요합니다.

Type:	PSCredential
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-MailboxServer

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

Type:	ServerIdParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-MonitoringContext

MonitoringContext 스위치는 결과에 관련 모니터링 이벤트와 성능 카운터를 포함합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

일반적으로 출력이 Microsoft System Center Operations Manager(SCOM)에 전달될 때 결과에 모니터링 이벤트 및 성능 카운터를 포함합니다.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-ResetTestAccountCredentials

ResetTestAccountCredentials 스위치는 이 명령을 실행하는 데 사용되는 테스트 계정의 암호를 다시 설정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

테스트 계정의 암호는 일반적으로 7일마다 다시 설정됩니다. 보안상의 이유로 암호를 다시 설정해야 할 때는 이 스위치를 사용하여 강제로 암호를 다시 설정하세요.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-RSTEndpoint

이 매개 변수는 Microsoft 내부에서 사용하도록 예약되어 있습니다.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-TestType

TestType 매개 변수는 명령이 내부 또는 외부 URL을 테스트하는지 여부를 지정합니다. 값은 내부 및 외부입니다. URL 매개 변수에는 이 매개 변수를 사용할 수 없습니다. TestType 매개 변수나 URL 매개 변수를 지정하지 않으면 기본값은 TestType:Internal입니다.

Type:	OwaConnectivityTestType
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-Timeout

Timeout 매개 변수는 테스트 작업이 완료되도록 기다릴 시간(초)을 지정합니다. Timeout 매개 변수의 기본값은 30초입니다. 시간 제한 값은 0초보다 크고 1시간(3,600초)보다 작게 지정해야 합니다. 이 매개 변수 값을 항상 5초 이상으로 구성하는 것이 좋습니다.

Type:	UInt32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-TrustAnySSLCertificate

TrustAnySSLCertificate 스위치를 사용하면 Exchange에서 신뢰할 수 없는 CA(인증 기관)의 인증서를 수락할 수 있습니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-URL

URL 매개 변수는 테스트할 URL을 지정합니다. 이 매개 변수는 단일 Outlook Web App URL을 테스트하려는 경우에만 필요합니다.

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

TestType 또는 ClientAccessServer 매개 변수에는 URL 매개 변수를 사용할 수 없습니다.

Type:	String
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-VirtualDirectoryName

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-WhatIf

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

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

입력

Input types

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

출력

Output types

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

다음을 통해 공유