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 |
此參數指定是否應該向使用者報告無法同步處理的項目。如果設為 |
BasicAuthEnabled |
選用 |
System.Boolean |
此參數會啟用或停用基本驗證。預設值是 |
ClientCertAuth |
選用 |
Microsoft.Exchange.Data.Directory.SystemConfiguration.ClientCertAuthTypes |
此參數指定用戶端憑證驗證的狀態。預設會停用用戶端憑證驗證。此參數的預設值是 |
CompressionEnabled |
選用 |
System.Boolean |
此參數是整數,可以識別套用至所指定 Exchange ActiveSync 虛擬目錄的壓縮。預設值是 |
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 技術資源中心.