Share via


Set-ActiveSyncVirtualDirectory(RTM)

 

적용 대상: Exchange Server 2007

마지막으로 수정된 항목: 2007-06-11

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

구문

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

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

자세한 정보

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

Set-ActiveSyncVirtualDirectory cmdlet를 실행하려면 사용하는 계정이 다음을 위임받아야 합니다.

  • 대상 서버에 대한 Exchange Server 관리자 역할 및 로컬 관리자 그룹

사용 권한, 역할 위임 및 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입니다.

DomainController

선택

Microsoft.Exchange.Data.Fqdn

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

ExternalAuthenticationMethods

선택

Microsoft.Exchange.Data.MultiValuedProperty

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

ExternalUrl

선택

System.Uri

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

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

이 매개 변수는 Autodiscover 서비스에서 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을 지정할 수 있습니다.

입력 형식

반환 형식

오류

오류 설명

 

 

예외

예외 설명

 

 

예제

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

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