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 指令程式，必須對您使用的帳戶委派 Exchange Server 系統管理員角色和目標伺服器本機 Administrators 群組的成員資格。

如需管理 Microsoft 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。

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 參數指定是否安裝網際網路伺服器 API (ISAPI) 篩選器。

InstallProxySubDirectory

選用

System.Boolean

InstallProxySubDirectory 參數控制如何建立做為 Exchange Server 2010 與 Exchange Server 2007 之 Proxy 的新 Exchange ActiveSync 子目錄的方式。

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。

WhatIf

選用

System.Management.Automation.SwitchParameter

此參數指示命令模擬它將對物件採取的動作。使用此參數，則不需要套用任何變更，就能檢視變更。您不需要為此參數指定值。

WindowsAuthEnabled

選用

System.Boolean

此參數指定是否在 Exchange ActiveSync 虛擬目錄上啟用整合式 Windows 驗證。

輸入類型

傳回類型

錯誤

錯誤 描述

 

 

例外狀況

例外狀況 描述

 

 

範例

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

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