Share via


New-OwaVirtualDirectory

 

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

마지막으로 수정된 항목: 2010-02-25

New-OWAVirtualDirectory cmdlet는 Microsoft Exchange Server 2007을 실행 중인 컴퓨터의 기존 IIS(인터넷 정보 서비스) 웹 사이트에 새로운 Outlook Web Access 가상 디렉터리를 만듭니다.

구문

New-OwaVirtualDirectory [-Name <String>] [-ApplicationRoot <String>] [-AppPoolId <String>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-ExternalAuthenticationMethods <MultiValuedProperty>] [-ExternalUrl <Uri>] [-InternalUrl <Uri>] [-OwaVersion <Exchange2003or2000 | Exchange2007>] [-Path <String>] [-TemplateInstance <PSObject>] [-VirtualDirectoryType <NotSpecified | Mailboxes | PublicFolders | Exchweb | Exadmin>] [-WebSiteName <String>] [-WhatIf [<SwitchParameter>]]

자세한 정보

기본적으로 Exchange 2007을 설치하면 Microsoft Exchange를 실행하는 로컬 서버의 기본 IIS 웹 사이트에 다음과 같은 Outlook Web Access 가상 디렉터리가 생성됩니다.

  • Owa   Exchange 2007 Outlook Web Access 가상 디렉터리입니다.

  • Exchange   Exchange Server 2003 또는 Exchange 2000 Server를 실행하는 서버에 사서함이 있는 사용자가 액세스할 수 있는 레거시 Outlook Web Access 가상 디렉터리입니다.

  • Public   Exchange 2003 또는 Exchange 2000을 실행하는 서버의 공용 폴더를 가리키는 레거시 Outlook Web Access 가상 디렉터리입니다.

  • Exchweb   사용자가 Outlook Web Access 가상 디렉터리에 액세스하는 데 사용할 수 있는 레거시 Outlook Web Access 가상 디렉터리입니다. 기본적으로 exchweb 가상 디렉터리에 대한 요청은 사용자의 사서함 서버로 전송됩니다.

    참고

    일반적으로 New-OWAVirtualDirectory cmdlet는 호스팅과 같은 추가 가상 디렉터리가 필요한 특수한 비즈니스 요구가 있거나 Outlook Web Access 가상 디렉터리 삭제 및 재생성과 같은 Outlook Web Access 문제 해결 작업에 대한 특수한 비즈니스 요구가 있는 경우에 사용됩니다.

New-OwaVirtualDirectory cmdlet는 새 가상 디렉터리를 호스팅하려는 클라이언트 액세스 서버 역할을 호스팅 중인 Exchange 2007 서버에서 실행되어야 합니다. 사용하는 계정이 대상 서버에 대한 Exchange Server 관리자 역할 및 로컬 관리자 그룹 구성원 자격을 위임받아야 합니다.

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

매개 변수

매개 변수 필수 종류 설명

ApplicationRoot

선택

System.String

이 매개 변수는 메타베이스에 가상 디렉터리 경로를 설정합니다.

참고

이 매개 변수는 구현되지 않았습니다.

AppPoolId

선택

System.String

이 매개 변수는 Outlook Web Access가 실행되는 IIS 응용 프로그램 풀을 설정합니다. 이 설정은 기본값으로 두는 것이 가장 좋습니다.

Confirm

선택

System.Management.Automation.SwitchParameter

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

DomainController

선택

Microsoft.Exchange.Data.Fqdn

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

ExternalAuthenticationMethods

선택

Microsoft.Exchange.Data.MultiValuedProperty

서비스 검색 속성 설정인 이 매개 변수는 방화벽 외부의 Exchange 서버에서 지원되는 인증 방법을 지정합니다.

참고

이 매개 변수는 구현되지 않았지만 Set-OwaVirtualDirectory를 사용하여 설정할 수 있습니다.

ExternalUrl

선택

System.Uri

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

참고

이 설정은 Exchange 2007 가상 디렉터리에만 구성할 수 있습니다. 기본 Exchange 2007 가상 디렉터리는 /owa입니다.

InternalUrl

선택

System.Uri

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

참고

이 설정은 Exchange 2007 가상 디렉터리에만 구성할 수 있습니다. 기본 Exchange 2007 가상 디렉터리는 /owa입니다.

Name

선택

System.String

이 매개 변수는 Exchange 2003 또는 Exchange 2000을 실행 중인 서버에 Outlook Web Access 가상 디렉터리가 있는 경우 Outlook Web Access 가상 디렉터리의 이름을 지정합니다.

Outlook Web Access 가상 디렉터리가 Exchange 2007 서버에 있으면 매개 변수가 무시됩니다.

OWAVersion

선택

Microsoft.Exchange.Data.Directory.SystemConfiguration.OwaVersions

이 매개 변수는 Outlook Web Access 가상 디렉터리의 버전이 Exchange 2007, Exchange 2003 또는 Exchange 2000인지를 지정합니다.

Path

선택

System.String

이 매개 변수는 가상 디렉터리의 파일 시스템 경로를 설정합니다. 이 매개 변수는 기본 이외의 다른 파일 시스템 경로를 사용해야 하는 경우에만 신중하게 사용되어야 합니다.

TemplateInstance

선택

System.Management.Automation.PSObject

이 매개 변수는 기존 개체를 이 매개 변수에 제공할 때 cmdlet에서 이 개체의 구성을 사용하여 개체의 동일한 복사본을 로컬 또는 대상 서버에 만들도록 지정합니다.

참고

이 매개 변수는 구현되지 않았습니다.

VirtualDirectoryType

선택

Microsoft.Exchange.Data.Directory.SystemConfiguration.VirtualDirectoryTypes

이 매개 변수는 Outlook Web Access 가상 디렉터리가 사서함, 공용 폴더 또는 exchweb을 가리킬지 여부를 지정합니다. 이 매개 변수는 Outlook Web Access 가상 디렉터리가 Exchange 2003 또는 Exchange 2000 서버에 있는 경우에만 필요합니다.

Outlook Web Access 가상 디렉터리가 Exchange 2007 서버에 있으면 이 매개 변수가 무시됩니다.

WebSiteName

선택

System.String

이 매개 변수는 Outlook Web Access 가상 디렉터리가 생성되는 IIS 웹 사이트의 이름을 지정합니다.

WhatIf

선택

System.Management.Automation.SwitchParameter

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

입력 형식

반환 형식

오류

오류 설명

 

 

예외

예외 설명

 

 

예제

다음 코드 예에서는 로컬 Exchange 서버의 기본 IIS 웹 사이트("contoso.com") 이외에 "exchange", "public" 및 "exchweb"이라는 새로운 Outlook Web Access 레거시 가상 디렉터리를 만듭니다.

New-OWAVirtualDirectory -OwaVersion:Exchange2003or2000 -VirtualDirectoryType Mailboxes -Name "exchange" -WebSiteName "Contoso.com"
New-OWAVirtualDirectory -OwaVersion:Exchange2003or2000 -VirtualDirectoryType PublicFolders -Name "public" -WebSiteName "Contoso.com"
New-OWAVirtualDirectory -OwaVersion:Exchange2003or2000 -VirtualDirectoryType Exchweb -Name "exchweb" -WebSiteName "Contoso.com"