New-ActiveSyncVirtualDirectory(RTM)
적용 대상: Exchange Server 2007
마지막으로 수정된 항목: 2007-06-11
New-ActiveSyncVirtualDirectory 명령을 사용하여 지정된 웹 사이트에 새 Microsoft Exchange ActiveSync 가상 디렉터리를 만들 수 있습니다.
구문
New-ActiveSyncVirtualDirectory [-ApplicationRoot <String>] [-AppPoolId <String>] [-DomainController <Fqdn>] [-ExternalAuthenticationMethods <MultiValuedProperty>] [-ExternalUrl <Uri>] [-InternalAuthenticationMethods <MultiValuedProperty>] [-InternalUrl <Uri>] [-Path <String>] [-Server <ServerIdParameter>] [-TemplateInstance <PSObject>] [-WebSiteName <String>]
자세한 정보
New-ActiveSyncVirtualDirectory 명령을 사용하면 새 Exchange ActiveSync 가상 디렉터리가 지정된 웹 사이트의 지정된 서버에 만들어집니다. 만들어지는 Exchange ActiveSync 가상 디렉터리의 이름은 "Microsoft-ActiveSync-Server"입니다. 하나의 Exchange ActiveSync 가상 디렉터리만 각 Exchange ActiveSync 웹 사이트에 있을 수 있습니다.
New-ActiveSyncVirtualDirectory cmdlet를 실행하려면 사용하는 계정이 다음을 위임받아야 합니다.
- 대상 서버에 대한 Exchange Server 관리자 역할 및 로컬 관리자 그룹
사용 권한, 역할 위임 및 Exchange Server 2007 관리에 필요한 권한에 대한 자세한 내용은 사용 권한 고려 사항을 참조하십시오.
매개 변수
| 매개 변수 | 필수 | 종류 | 설명 |
|---|---|---|---|
ApplicationRoot |
선택 |
System.String |
이 매개 변수는 가상 디렉터리의 메타베이스 경로를 설정합니다. 기본적으로 이 경로는 가상 디렉터리가 만들어지는 웹 사이트와 같습니다. |
AppPoolId |
선택 |
System.String |
이 매개 변수는 가상 디렉터리와 함께 사용할 수 있는 프로그램 풀을 설정합니다. |
DomainController |
선택 |
Microsoft.Exchange.Data.Fqdn |
이 구성 변경을 Active Directory에 기록하는 도메인 컨트롤러의 FQDN(정규화된 도메인 이름)을 지정하려면 명령에 DomainController 매개 변수를 포함시킵니다. |
ExternalAuthenticationMethods |
선택 |
Microsoft.Exchange.Data.MultiValuedProperty |
이 매개 변수는 네트워크의 방화벽 외부에서 액세스를 요청할 때 가상 디렉터리가 포함된 서버에서 지원하는 인증 방법을 지정합니다. 이 매개 변수를 설정하지 않으면 모든 인증 방법을 사용할 수 있습니다. |
ExternalUrl |
선택 |
System.Uri |
이 매개 변수는 네트워크의 방화벽 외부에서 가상 디렉터리에 연결하기 위해 사용되는 URL(Uniform Resource Locator)을 지정합니다. |
InternalAuthenticationMethods |
선택 |
Microsoft.Exchange.Data.MultiValuedProperty |
이 매개 변수는 네트워크의 방화벽 내부에서 액세스를 요청할 때 가상 디렉터리가 포함된 서버에서 지원하는 인증 방법을 지정합니다. 이 매개 변수를 설정하지 않으면 모든 인증 방법을 사용할 수 있습니다. |
InternalUrl |
선택 |
System.Uri |
이 매개 변수는 네트워크의 방화벽 내부에서 가상 디렉터리에 연결하기 위해 사용되는 URL을 지정합니다. |
Path |
선택 |
System.String |
이 매개 변수는 가상 디렉터리의 시스템 파일이 포함된 디렉터리를 설정합니다. |
Server |
선택 |
Microsoft.Exchange.Configuration.Tasks.ServerIdParameter |
이 매개 변수는 새 Exchange ActiveSync 가상 디렉터리가 만들어지는 서버를 정의합니다. |
TemplateInstance |
선택 |
System.Management.Automation.PSObject |
이 매개 변수에 기존 개체를 제공하면 명령이 해당 개체의 구성을 사용하여 로컬 또는 대상 서버에 이 개체의 복제본을 만듭니다. |
WebSiteName |
선택 |
System.String |
이 매개 변수는 새 가상 디렉터리가 만들어지는 Exchange ActiveSync 웹 사이트의 이름을 지정합니다. |
입력 형식
반환 형식
오류
| 오류 | 설명 |
|---|---|
예외
| 예외 | 설명 |
|---|---|
예제
다음은 서버 Contoso에서 새 가상 디렉터리를 만드는 코드 예제입니다.
New-ActiveSyncVirtualDirectory -Server "Contoso" -WebSiteName "Contoso/Default Web Site" -ExternalURL "https://www.contoso.com/Microsoft-Server-ActiveSync"