New-WebServicesVirtualDirectory
적용 대상: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
마지막으로 수정된 항목: 2007-08-20
New-WebServicesVirtualDirectory cmdlet를 사용하면 클라이언트 액세스 서버 역할이 설치되어 있는 Microsoft Exchange Server 2007을 실행하는 컴퓨터에 EWS라는 새 가상 디렉터리를 만들 수 있습니다.
구문
New-WebServicesVirtualDirectory [-ApplicationRoot <String>] [-AppPoolId <String>] [-BasicAuthentication <$true | $false>] [-Confirm [<SwitchParameter>]] [-DigestAuthentication <$true | $false>] [-DomainController <Fqdn>] [-ExternalUrl <Uri>] [-InternalNLBBypassUrl <Uri>] [-InternalUrl <Uri>] [-Path <String>] [-TemplateInstance <PSObject>] [-WebSiteName <String>] [-WhatIf [<SwitchParameter>]] [-WindowsAuthentication <$true | $false>]
자세한 정보
New-WebServicesVirtualDirectory cmdlet를 사용하여 Exchange 2007 클라이언트 액세스 서버에 EWS라는 새 가상 디렉터리를 만들 수 있습니다. 이 cmdlet를 사용하여 여러 개의 가상 디렉터리를 만들 수 있습니다.
참고
웹 사이트마다 하나의 EWS 가상 디렉터리만 만들 수 있습니다.
New-WebServicesVirtualDirectory cmdlet를 실행하려면 사용하는 계정이 대상 서버에 대한 Exchange Server 관리자 역할과 로컬 관리자 그룹 구성원 자격을 위임받아야 합니다.
사용 권한, 역할 위임 및 Exchange 2007 관리에 필요한 권한에 대한 자세한 내용은 사용 권한 고려 사항을 참조하십시오.
매개 변수
| 매개 변수 | 필수 | 종류 | 설명 |
|---|---|---|---|
ApplicationRoot |
선택 |
System.String |
이 매개 변수는 가상 디렉터리의 메타베이스 경로를 설정합니다. 기본적으로 이 경로는 가상 디렉터리가 만들어지는 웹 사이트와 같습니다. |
AppPoolId |
선택 |
System.String |
이 매개 변수는 가상 디렉터리와 함께 사용할 수 있는 프로그램 풀을 설정합니다. |
BasicAuthentication |
선택 |
System.Boolean |
이 매개 변수는 EWS 가상 디렉터리에서 기본 인증을 사용하도록 설정할지 여부를 지정합니다. |
Confirm |
선택 |
System.Management.Automation.SwitchParameter |
Confirm 매개 변수는 명령에서 처리 작업을 일시 중지하도록 하고 처리 작업을 계속하기 전 수행할 작업을 사용자가 확인하도록 합니다. Confirm 매개 변수에는 값을 지정할 필요가 없습니다. |
DigestAuthentication |
선택 |
System.Boolean |
이 매개 변수를 사용하여 가상 디렉터리에 다이제스트 인증을 사용하도록 지정합니다. |
DomainController |
선택 |
Microsoft.Exchange.Data.Fqdn |
이 구성 변경을 Active Directory 디렉터리 서비스에 기록하는 도메인 컨트롤러의 FQDN(정규화된 도메인 이름)을 지정하려면 cmdlet에 DomainController 매개 변수를 포함시킵니다. |
ExternalUrl |
선택 |
System.Uri |
이 매개 변수는 경계 네트워크 외부에서 Exchange Server에 연결하는 데 사용되는 호스트 이름을 지정합니다. |
InternalNLBBypassUrl |
선택 |
System.Uri |
이 매개 변수는 클라이언트 액세스 서버가 NLB(네트워크 부하 분산) 배열 뒤에 있는지 여부와 상관없이 해당 클라이언트 액세스 서버의 URL을 지정합니다. InternalUrl 매개 변수를 NLB의 URL로 설정하더라도 InternalNLBBypassUrl 매개 변수는 항상 클라이언트 액세스 서버의 URL로 설정해야 합니다. 그 이유는 특정 Exchange 웹 서비스 호출의 경우 시스템 선호도가 있어야 하고 Exchange 웹 서비스에서 들어오는 호출을 더 적합한 클라이언트 액세스 서버에 프록시하기 때문입니다. |
InternalUrl |
선택 |
System.Uri |
이 매개 변수는 네트워크 방화벽 내부에서 가상 디렉터리에 연결하기 위해 사용되는 URL을 지정합니다. |
Path |
선택 |
System.String |
이 매개 변수는 메타베이스에 가상 디렉터리 경로를 설정합니다. |
TemplateInstance |
선택 |
System.Management.Automation.PSObject |
이 매개 변수에 기존 개체를 제공하면 명령이 해당 개체의 구성을 사용하여 로컬 또는 대상 서버에 개체의 복사본을 만듭니다. |
WebSiteName |
선택 |
System.String |
이 매개 변수는 새 가상 디렉터리를 만들 웹 사이트의 이름을 지정합니다. 기본 웹 사이트에 새 가상 디렉터리를 만드는 경우에는 이 매개 변수를 사용해서는 안 됩니다. |
WindowsAuthentication |
선택 |
System.Boolean |
이 매개 변수를 사용하여 새 Exchange Web Services 가상 디렉터리에 Windows 통합 인증을 허용할지 여부를 지정합니다. |
WhatIf |
선택 |
System.Management.Automation.SwitchParameter |
WhatIf 매개 변수는 명령 실행 시 개체에 대해 수행하게 되는 작업을 시뮬레이트하도록 지시합니다. WhatIf 매개 변수를 사용하면 사용자는 변경 내용을 실제로 적용하지 않고 어떠한 사항이 변경되는지 확인할 수 있습니다. WhatIf 매개 변수에는 값을 지정할 필요가 없습니다. |
입력 형식
반환 형식
오류
| 오류 | 설명 |
|---|---|
|
|
예외
| 예외 | 설명 |
|---|---|
|
|
예제
다음 코드 예는 외부 URL이 "https://www.contoso.com/webservices.aspx"로 설정된 "contoso"라는 새 가상 디렉터리를 만듭니다.
New-WebServicesVirtualDirectory -WebsiteName "www.contoso.com" -ExternalUrl "https://www.contoso.com/webservices.aspx"