Set-WebServicesVirtualDirectory(RTM)
적용 대상: Exchange Server 2007
마지막으로 수정된 항목: 2007-06-11
Set-WebServicesVirtualDirectory cmdlet를 사용하면 클라이언트 액세스 서버 역할이 설치되어 있는 Exchange 2007 컴퓨터에서 기존 Exchange 웹 서비스 가상 디렉터리를 수정할 수 있습니다.
구문
Set-WebServicesVirtualDirectory -Identity <VirtualDirectoryIdParameter> [-BasicAuthentication <$true | $false>] [-DigestAuthentication <$true | $false>] [-DomainController <Fqdn>] [-ExternalUrl <Url>] [-InternalUrl <Url>] [-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과 함께 사용할 수 있습니다. |
DigestAuthentication |
선택 |
System.Boolean |
이 매개 변수는 가상 디렉터리에 다이제스트 인증을 설정할지 여부를 지정합니다. |
DomainController |
선택 |
System.String |
Active Directory 디렉터리 서비스에서 데이터를 검색하는 도메인 컨트롤러의 FQDN(정규화된 도메인 이름)을 지정하려면 cmdlet에 DomainController 매개 변수를 포함시킵니다. |
ExternalUrl |
선택 |
System.Uri |
이 매개 변수는 방화벽 외부에 있는 Exchange 서버에 연결할 때 사용되는 호스트 이름을 지정합니다. 이 설정은 또한 SSL(Secure Sockets Layer)을 사용하는 경우에도 중요합니다. |
Instance |
선택 |
Microsoft.Exchange.Data.Directory.SystemConfiguration.ADWebServicesVirtualDirectory |
Instance 매개 변수를 사용하면 처리할 cmdlet에 전체 개체를 전달할 수 있습니다. |
InternalUrl |
선택 |
System.Uri |
이 매개 변수는 방화벽 내부에서 연결하기 위한 Exchange 서버의 호스트 이름을 지정합니다. 이 설정은 또한 SSL을 사용하는 경우에도 중요합니다. |
WindowsAuthentication |
선택 |
System.Boolean |
이 매개 변수는 Exchange 웹 서비스 가상 디렉터리에서 Windows 통합 인증을 허용할지 여부를 지정합니다. |
입력 형식
반환 형식
오류
| 오류 | 설명 |
|---|---|
|
|
예외
| 예외 | 설명 |
|---|---|
|
|
예제
다음 코드 예는 "Contoso"라는 서버에서 "EWS"라는 가상 디렉터리에 대해 인증 방법을 기본 인증으로 설정합니다. 이 코드 예에서는 이 가상 디렉터리에 대한 외부 및 내부 URL도 설정합니다.
두 번째 코드 예에서는 "기본 웹 사이트" 대신 와일드카드 문자를 사용합니다.
Set-WebServicesVirtualDirectory -Identity Contoso\EWS(default web site)-ExternalUrl https://www.contoso.com/EWS/exchange.aspx -ExternalAuthenticationMethods Basic -InternalUrl https://contoso.internal.com/EWS/webservices.aspx
Set-WebServicesVirtualDirectory -Identity Contoso\EWS* -ExternalUrl https://www.contoso.com/ews/exchange.aspx