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 指令程式,必須對您使用的帳戶委派下列項目:

  • Exchange Server 系統管理員角色和目標伺服器的本機 Administrators 群組

如需管理 Exchange Server 2007 所需之權限、委派角色及權利的相關資訊,請參閱權限考量

參數

參數 必要 類型 描述

Identity

必要

Microsoft.Exchange.Configuration.Tasks.VirtualDirectoryIdParameter

此參數會唯一地識別要設定的 Exchange ActiveSync 虛擬目錄。此值必須為 website\microsoft-server-activesync。

ActiveSyncServer

選用

System.String

此參數指定 Client Access Server 的 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

此參數是用於 Client Access server HTTP Proxy 功能。如果設定,則接收用戶端連線的 Client Access Server 會將要求 Proxy 至此 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。

輸入類型

傳回類型

錯誤

錯誤 描述

 

 

例外狀況

例外狀況 描述

 

 

範例

下列程式碼範例會停用 Contoso 伺服器之預設 Exchange ActiveSync 虛擬目錄上的基本驗證。

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

若要確保您目前閱讀的是最新資訊,並尋找其他的 Exchange Server 2007 說明文件,請造訪 Exchange Server 技術資源中心.