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 cmdlet，必须为您使用的帐户委派 Exchange Server 管理员角色以及目标服务器的本地 Administrators 组成员身份。

有关管理 Microsoft 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。

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 参数可指定是否安装 Internet 服务器 API (ISAPI) 过滤器。

InstallProxySubDirectory

可选

System.Boolean

InstallProxySubDirectory 参数控制创建新的 Exchange ActiveSync 子目录的方式，该子目录用作 Microsoft Exchange Server 2010 和 Exchange Server 2007 间的代理。

Instance

可选

Microsoft.Exchange.Data.Directory.SystemConfiguration.ADMobileVirtualDirectory

使用 Instance 参数可以将整个对象传递给此命令以进行处理。该参数主要用于必须将整个对象传递给命令的脚本。

InternalAuthenticationMethods

可选

Microsoft.Exchange.Data.MultiValuedProperty

此参数指定在从网络防火墙内部请求访问时，包含虚拟目录的服务器所支持的身份验证方法。如果未设置此参数，则可以使用所有身份验证方法。

InternalUrl

可选

System.Uri

此参数用于客户端访问服务器 HTTP 代理功能。如果设置此参数，则接收传入客户端连接的客户端访问服务器将把请求转发到此 URL。这可以是面向 Internet 的完全限定的域名 (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 的组织。在这些环境下，可以指定一个或多个 FQDN，在收到远程文件访问时 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