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 cmdlet，必须为您使用的帐户委派下列角色：

• Exchange Server 管理员角色和目标服务器的本地 Administrators 组

有关管理 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。
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	此参数用于客户端访问服务器 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。

输入类型

返回类型

错误

错误	说明

异常

异常	说明

示例

以下代码示例将禁用名为 Contoso 的服务器上的默认 Exchange ActiveSync 虚拟目录的基本身份验证。

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