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 |
此参数指定是否应向用户报告无法同步的项目。如果设置为 |
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 参数可指定是否安装 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