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