Set-ActiveSyncVirtualDirectory

  • 아티클

 

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

마지막으로 수정된 항목: 2012-03-26

Set-ActiveSyncVirtualDirectory 명령을 사용하여 지정한 가상 디렉터리에 Microsoft Exchange ActiveSync 설정을 구성할 수 있습니다.

구문

Set-ActiveSyncVirtualDirectory -Identity <VirtualDirectoryIdParameter> [-ActiveSyncServer <String>] [-BadItemReportingEnabled <$true | $false>] [-BasicAuthEnabled <$true | $false>] [-ClientCertAuth <Ignore | Accepted | Required>] [-CompressionEnabled <$true | $false>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-ExternalAuthenticationMethods <MultiValuedProperty>] [-ExternalUrl <Uri>] [-InstallIsapiFilter <$true | $false>] [-InstallProxySubDirectory <$true | $false>] [-InternalAuthenticationMethods <MultiValuedProperty>] [-InternalUrl <Uri>] [-MobileClientCertificateAuthorityURL <String>] [-MobileClientCertificateProvisioningEnabled <$true | $false>] [-MobileClientCertTemplateName <String>] [-Name <String>] [-RemoteDocumentsActionForUnknownServers <Nullable>] [-RemoteDocumentsAllowedServers <MultiValuedProperty>] [-RemoteDocumentsBlockedServers <MultiValuedProperty>] [-RemoteDocumentsInternalDomainSuffixList <MultiValuedProperty>] [-WhatIf [<SwitchParameter>]] [-WindowsAuthEnabled <$true | $false>]

Set-ActiveSyncVirtualDirectory [-ActiveSyncServer <String>] [-BadItemReportingEnabled <$true | $false>] [-BasicAuthEnabled <$true | $false>] [-ClientCertAuth <Ignore | Accepted | Required>] [-CompressionEnabled <$true | $false>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-ExternalAuthenticationMethods <MultiValuedProperty>] [-ExternalUrl <Uri>] [-InstallIsapiFilter <$true | $false>] [-InstallProxySubDirectory <$true | $false>] [-Instance <ADMobileVirtualDirectory>] [-InternalAuthenticationMethods <MultiValuedProperty>] [-InternalUrl <Uri>] [-MobileClientCertificateAuthorityURL <String>] [-MobileClientCertificateProvisioningEnabled <$true | $false>] [-MobileClientCertTemplateName <String>] [-Name <String>] [-RemoteDocumentsActionForUnknownServers <Nullable>] [-RemoteDocumentsAllowedServers <MultiValuedProperty>] [-RemoteDocumentsBlockedServers <MultiValuedProperty>] [-RemoteDocumentsInternalDomainSuffixList <MultiValuedProperty>] [-WhatIf [<SwitchParameter>]] [-WindowsAuthEnabled <$true | $false>]

자세한 정보

Set-ActiveSyncVirtualDirectory 명령을 사용하여 Exchange ActiveSync에 사용되는 가상 디렉터리에 다양한 설정을 구성할 수 있습니다.

Set-ActiveSyncVirtualDirectory cmdlet를 실행하려면 사용하는 계정이 대상 서버에 대한 Exchange Server 관리자 역할과 로컬 관리자 그룹 구성원 자격을 위임받아야 합니다.

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

매개 변수

매개 변수 필수 종류 설명

Identity

필수

Microsoft.Exchange.Configuration.Tasks.VirtualDirectoryIdParameter

이 매개 변수는 구성할 Exchange ActiveSync 가상 디렉터리를 고유하게 식별합니다. 이 값은 website\microsoft-server-activesync여야 합니다.

ActiveSyncServer

선택

System.String

이 매개 변수는 클라이언트 액세스 서버의 URL을 지정합니다. 형식은 https://servername/Microsoft-Server-ActiveSync입니다.

BadItemReportingEnabled

선택

System.Boolean

이 매개 변수는 동기화될 수 없는 항목을 사용자에게 보고할지 여부를 지정합니다. $true로 설정되면 항목이 모바일 장치로 동기화될 수 없는 경우 사용자는 알림을 받습니다.

BasicAuthEnabled

선택

System.Boolean

이 매개 변수는 기본 인증을 사용하거나 사용하지 않도록 설정합니다. 기본 설정은 $true입니다.

ClientCertAuth

선택

Microsoft.Exchange.Data.Directory.SystemConfiguration.ClientCertAuthTypes

이 매개 변수는 클라이언트 인증서의 인증 상태를 지정합니다. 기본적으로 클라이언트 인증서 인증을 사용할 수 없습니다. 이 매개 변수의 기본값은 $null입니다.

CompressionEnabled

선택

System.Boolean

이 매개 변수는 지정한 Exchange ActiveSync 가상 디렉터리에 적용된 압축을 식별하는 정수입니다. 기본 설정은 $true입니다.

Confirm

선택

System.Management.Automation.SwitchParameter

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

DomainController

선택

Microsoft.Exchange.Data.Fqdn

이 구성 변경을 Active Directory 디렉터리 서비스에 기록하는 도메인 컨트롤러의 FQDN(정규화된 도메인 이름)을 지정하려면 해당 명령에 DomainController 매개 변수를 포함시킵니다.

ExternalAuthenticationMethods

선택

Microsoft.Exchange.Data.MultiValuedProperty

이 매개 변수는 네트워크의 방화벽 외부에서 액세스를 요청할 때 가상 디렉터리가 포함된 서버에서 지원하는 인증 방법을 지정합니다. 이 매개 변수를 설정하지 않으면 모든 인증 방법을 사용할 수 있습니다.

ExternalUrl

선택

System.Uri

이 매개 변수는 네트워크의 방화벽 외부에서 가상 디렉터리에 연결하기 위해 사용되는 URL을 지정합니다.

InstallIsapiFilter

선택

System.Boolean

InstallIsapiFilter 매개 변수는 ISAPI(인터넷 서버 API) 필터를 설치하는지를 지정합니다.

InstallProxySubDirectory

선택

System.Boolean

InstallProxySubDirectory 매개 변수는 Microsoft Exchange Server 2010과 Exchange Server 2007 간에 프록시로 사용되는 새 Exchange ActiveSync 하위 디렉터리를 만드는 방법을 제어합니다.

Instance

선택

Microsoft.Exchange.Data.Directory.SystemConfiguration.ADMobileVirtualDirectory

Instance 매개 변수를 사용하면 전체 개체를 처리할 명령에 전달할 수 있습니다. 이 매개 변수는 주로 전체 개체를 명령에 전달해야 하는 스크립트에 사용됩니다.

InternalAuthenticationMethods

선택

Microsoft.Exchange.Data.MultiValuedProperty

이 매개 변수는 네트워크의 방화벽 내부에서 액세스를 요청할 때 가상 디렉터리가 포함된 서버에서 지원하는 인증 방법을 지정합니다. 이 매개 변수를 설정하지 않으면 모든 인증 방법을 사용할 수 있습니다.

InternalUrl

선택

System.Uri

이 매개 변수는 클라이언트 액세스 서버 HTTP 프록시 기능에 사용됩니다. 이 매개 변수가 설정되면 들어오는 클라이언트 연결을 받는 클라이언트 액세스 서버에서 요청을 이 URL로 프록시합니다. 이것은 인터넷용 FQDN(정규화된 도메인 이름) URL 또는 내부 호스트 이름일 수 있습니다.

MobileClientCertificateAuthorityURL

선택

System.String

이 매개 변수는 모바일 장치에서 사용하는 CA(인증 기관)의 URL을 지정합니다.

MobileClientCertificateProvisioningEnabled

선택

System.Boolean

이 매개 변수는 자동 검색 서비스에서 XML 파일에 인증서 서비스 서버 URL을 반환할지 여부를 지정합니다.

MobileClientCertTemplateName

선택

System.String

이 매개 변수는 클라이언트 인증서의 템플릿 이름을 지정합니다.

Name

선택

System.String

이 매개 변수는 Exchange ActiveSync 가상 디렉터리의 이름을 지정합니다.

RemoteDocumentsActionForUnknownServers

선택

System.Nullable

이 매개 변수는 Exchange ActiveSync를 통해 Windows SharePoint Services 또는 Windows 파일 공유 요청이 들어올 때 발생하는 작업을 지정합니다. 요청이 들어오면 Exchange ActiveSync는 허용 및 차단 목록에서 요청된 호스트 이름을 검색합니다. 목록에 호스트 이름이 없는 경우 이 매개 변수에 지정된 차단 또는 허용 작업이 수행됩니다.

RemoteDocumentsAllowedServers

선택

Microsoft.Exchange.Data.MultiValuedProperty

이 매개 변수는 원격 문서 액세스에 허용된 모든 서버를 나열하는 다중값 속성입니다.

RemoteDocumentsBlockedServers

선택

Microsoft.Exchange.Data.MultiValuedProperty

이 매개 변수는 원격 문서 액세스에 차단된 모든 서버를 나열하는 다중값 속성입니다.

RemoteDocumentsInternalDomainSuffixList

선택

Microsoft.Exchange.Data.MultiValuedProperty

이 매개 변수는 네트워크에서 WINS를 실행하지 않는 조직에 사용됩니다. 이러한 환경에서 원격 파일 액세스 요청을 받은 경우 Exchange ActiveSync가 내부로 처리하는 하나 이상의 FQDN을 지정할 수 있습니다.

WhatIf

선택

System.Management.Automation.SwitchParameter

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

WindowsAuthEnabled

선택

System.Boolean

이 매개 변수는 Exchange ActiveSync 가상 디렉터리에 통합된 Windows 인증을 사용하도록 설정할지 여부를 지정합니다.

입력 형식

반환 형식

오류

오류 설명

 

 

예외

예외 설명

 

 

예제

다음 코드 예는 Contoso라는 서버에 있는 기본 Exchange ActiveSync 가상 디렉터리에서 기본 인증을 사용할 수 없도록 설정합니다.

Set-ActiveSyncVirtualDirectory -Identity "contoso\microsoft-server-activesync" -BasicAuthEnabled:$false