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