Set-WebServicesVirtualDirectory

  • 아티클

 

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

마지막으로 수정된 항목: 2011-06-21

Set-WebServicesVirtualDirectory cmdlet를 사용하면 클라이언트 액세스 서버 역할이 설치되어 있는 Exchange 2007 컴퓨터에서 기존 Exchange 웹 서비스 가상 디렉터리를 수정할 수 있습니다.

구문

Set-WebServicesVirtualDirectory -Identity <VirtualDirectoryIdParameter> [-BasicAuthentication <$true | $false>] [-Confirm [<SwitchParameter>]] [-DigestAuthentication <$true | $false>] [-DomainController <Fqdn>] [-ExternalUrl <Uri>] [-InternalNLBBypassUrl <Uri>] [-InternalUrl <Uri>] [-WhatIf [<SwitchParameter>]] [-WindowsAuthentication <$true | $false>]

Set-WebServicesVirtualDirectory [-BasicAuthentication <$true | $false>] [-Confirm [<SwitchParameter>]] [-DigestAuthentication <$true | $false>] [-DomainController <Fqdn>] [-ExternalUrl <Uri>] [-Instance <ADWebServicesVirtualDirectory>] [-InternalNLBBypassUrl <Uri>] [-InternalUrl <Uri>] [-WhatIf [<SwitchParameter>]] [-WindowsAuthentication <$true | $false>]

자세한 정보

Set-WebServicesVirtualDirectory cmdlet를 사용하면 Exchange 2007 클라이언트 액세스 서버에서 기존 Exchange 웹 서비스 가상 디렉터리를 수정할 수 있습니다.

참고

클라이언트 액세스 서버 집합의 부하가 분산되어 있는 경우에는 이 cmdlet를 실행할 때 각 서버의 이름을 지정하지 않아도 됩니다. 즉, 네트워크 부하 분산 서버 중 하나의 이름만 사용하면 됩니다.

Set-WebServicesVirtualDirectory cmdlet를 실행하려면 사용하는 계정이 대상 서버에 대한 Exchange Server 관리자 역할과 로컬 관리자 그룹 구성원 자격을 위임받아야 합니다.

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

매개 변수

매개 변수 필수 종류 설명

Identity

필수

Microsoft.Exchange.Configuration.Tasks.VirtualDirectoryIdParameter

이 매개 변수는 가상 디렉터리의 이름을 지정합니다. 기본 웹 사이트 대신 와일드카드 문자를 지정해도 됩니다.

BasicAuthentication

선택

System.Boolean

이 매개 변수는 Exchange 웹 서비스 가상 디렉터리에서 기본 인증을 사용하도록 설정할지 여부를 지정합니다. 이 매개 변수는 FormsAuthentication 또는 DigestAuthentication 및 WindowsAuthentication과 함께 사용할 수 있습니다.

Confirm

선택

System.Management.Automation.SwitchParameter

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

DigestAuthentication

선택

System.Boolean

이 매개 변수는 가상 디렉터리에 다이제스트 인증을 설정할지 여부를 지정합니다.

DomainController

선택

Microsoft.Exchange.Data.Fqdn

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

ExternalUrl

선택

System.Uri

이 매개 변수는 방화벽 외부에 있는 Exchange 서버에 연결할 때 사용되는 호스트 이름을 지정합니다. 이 설정은 또한 SSL(Secure Sockets Layer)을 사용하는 경우에도 중요합니다.

Instance

선택

Microsoft.Exchange.Data.Directory.SystemConfiguration.ADWebServicesVirtualDirectory

Instance 매개 변수를 사용하면 처리할 cmdlet에 전체 개체를 전달할 수 있습니다.

InternalNLBBypassUrl

선택

System.Uri

이 매개 변수는 클라이언트 액세스 서버가 NLB(네트워크 부하 분산 장치) 뒤에 있는 경우에도 클라이언트 액세스 서버의 URL을 지정합니다.

InternalUrl

선택

System.Uri

이 매개 변수는 방화벽 내부에서 연결하기 위한 Exchange 서버의 호스트 이름을 지정합니다. 이 설정은 또한 SSL을 사용하는 경우에도 중요합니다.

WhatIf

선택

System.Management.Automation.SwitchParameter

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

WindowsAuthentication

선택

System.Boolean

이 매개 변수는 Exchange 웹 서비스 가상 디렉터리에서 Windows 통합 인증을 허용할지 여부를 지정합니다.

입력 형식

반환 형식

오류

오류 설명

 

 

예외

예외 설명

 

 

예제

다음 코드 예는 "Contoso"라는 서버에서 "EWS"라는 가상 디렉터리에 대해 인증 방법을 기본 인증으로 설정합니다. 또한 이 가상 디렉터리에 대해 외부 및 내부 URL도 설정합니다.

두 번째 코드 예에서는 "기본 웹 사이트" 대신 와일드카드 문자를 사용합니다.

Set-WebServicesVirtualDirectory -Identity Contoso\EWS(default web site)-ExternalUrl https://www.contoso.com/EWS/exchange.asmx - BasicAuthentication $true InternalUrl https://contoso.internal.com/EWS/webservices.aspx
Set-WebServicesVirtualDirectory -Identity Contoso\EWS* -ExternalUrl https://www.contoso.com/ews/exchange.asmx