Set-RpcClientAccess

此 cmdlet 仅适用于本地 Exchange。

使用 Set-RpcClientAccess cmdlet 修改安装了客户端访问服务器角色的 Exchange 服务器上Microsoft Exchange RPC 客户端访问服务的设置。 这些设置会影响使用 Outlook Anywhere (RPC over HTTP) 连接的 Outlook 客户端。

有关以下语法部分的参数设置的详细信息,请参阅 Exchange cmdlet 语法

语法

Default (默认值)

Set-RpcClientAccess
    -Server <ServerIdParameter>
    [-BlockedClientVersions <String>]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-EncryptionRequired <Boolean>]
    [-MaximumConnections <Int32>]
    [-Name <String>]
    [-WhatIf]
    [<CommonParameters>]

说明

Exchange 2016 或更高版本不支持 Outlook 2007,因此不应在版本 12.Y.Z 或更低版本中看到 Outlook 连接。但是,在阻止任何客户端版本之前,应监视 RPC 客户端访问日志,以查看连接到 Exchange 服务器的客户端版本。

若要阻止特定邮箱的 Outlook 版本,请使用 Set-CASMailbox cmdlet。

您必须先获得权限,然后才能运行此 cmdlet。 尽管本文列出了 cmdlet 的所有参数,但如果某些参数未包含在分配给你的权限中,则可能无法访问这些参数。 若要查找在贵组织中运行任何 cmdlet 或参数所需的权限,请参阅 Find the permissions required to run any Exchange cmdlet

示例

示例 1

Set-RpcClientAccess -Server MBX01 -BlockedClientVersions 14.0.0-14.32767.65535

本示例阻止 Outlook 2010 客户端在名为 MBX01 的服务器上建立 Outlook Anywhere 连接。

示例 2

Set-RpcClientAccess -Server MBX01 -BlockedClientVersions 15.0.0-15.4737.999

本示例阻止未在名为 MBX01 的服务器上安装 (版本 15.0.4737.1000) 的 Outlook 2013 客户端KB3054940 Outlook Anywhere 连接。

注意:可以通过分析位于 %ExchangeInstallPath%Logging\RPC 客户端访问处的 RPC 客户端访问日志文件来确定特定的客户端软件版本。

参数

-BlockedClientVersions

适用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

BlockedClientVersions 参数指定不允许连接到指定的 Exchange 服务器的 RPC 客户端版本。 例如,如果 Outlook 版本为指定值或处于指定范围,则 Microsoft Exchange RPC 客户端访问服务将拒绝 Outlook Anywhere 连接。

有效版本值的格式为 X.Y.Z。RPC 客户端版本通常以格式 X.0.Y.Z 进行报告,但针对此参数,您需要将该值指定为 X.Y.Z。

  • X 是主版本号。 例如,Outlook 2016为 16,Outlook 2013 为 15,Outlook 2010 为 14。
  • Y 是次版本号,并且必须小于或等于 32767。
  • Z 是内部版本号,并且必须小于或等于 65535。

您可以指定范围。 例如,-13.32767.65535、14.0.0-14.32767.65535 或 15.0.0-。

您可以指定多个用分号 (;) 分隔的不相邻值或范围值。

限制客户端访问时要小心,因为 Exchange 服务器组件也可能使用 RPC 登录。 某些组件可能会将其客户端版本报告为文本字符串,而其他组件可能会报告 Exchange 内部版本号。 监视 RPC 客户端访问日志,查看在阻止任何客户端版本之前连接到 Exchange 服务器的客户端版本。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Confirm

适用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

Confirm 开关指定是否显示确认提示。 此开关对 cmdlet 造成的影响取决于在你继续操作之前 cmdlet 是否需要确认。

  • 破坏性 cmdlet(例如 Remove-* cmdlets)内置有暂停,可强制要求先确认命令,然后再继续操作。 对于这些 cmdlet,您可以使用此确切语法跳过确认提示:-Confirm:$false
  • 其他大多数 cmdlet(例如 New-* 和 Set-* cmdlet)都没有内置暂停。 对于这些 cmdlet,指定不含值的 Confirm 开关会引入暂停,从而强制要求你先确认命令,然后再继续操作。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False
别名:cf

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-DomainController

适用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

DomainController 参数指定此 cmdlet 从 Active Directory 读取数据或向其写入数据时使用的域控制器。 可以使用完全限定的域名 (FQDN) 来标识域控制器。 例如,dc01.contoso.com。

参数属性

类型:Fqdn
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-EncryptionRequired

适用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

EncryptionRequired 参数指定 RPC 客户端连接是否需要加密。 有效值包含:

  • $true:拒绝未加密的 RPC 客户端连接。 此值为默认值。
  • $false:允许未加密的 RPC 客户端连接。

参数属性

类型:Boolean
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-MaximumConnections

适用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

MaximumConnections 参数指定Microsoft Exchange RPC 客户端访问服务允许的最大并发客户端连接数。 默认值为 65536。

注意:虽然可以为此参数配置非默认值,但不会强制执行对此设置的更改。

参数属性

类型:Int32
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Name

适用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

Name 参数指定 Active Directory 中配置对象的名称。 默认情况下,此参数设置为 RpcClientAccess。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Server

适用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

Server 参数指定要在其中运行此命令的客户端访问服务器。 可以使用唯一标识该服务器的任何值。 例如:

  • 名称
  • FQDN
  • 可分辨名称 (DN)
  • ExchangeLegacyDN

参数属性

类型:ServerIdParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:True
来自管道的值:True
来自管道的值(按属性名称):True
来自剩余参数的值:False

-WhatIf

适用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

WhatIf 开关模拟命令操作。 可以使用此开关在不实际应用将会发生的更改的情况下预览这些更改。 不必为此开关指定值。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False
别名:无线

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

CommonParameters

此 cmdlet 支持通用参数:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息,请参阅 about_CommonParameters

输入

Input types

若要了解此 cmdlet 接受的输入类型,请参阅 cmdlet 的输入和输出类型。 如果 cmdlet 的"输入类型"字段为空,则表明此 cmdlet 不接受输入数据。

输出

Output types

若要了解此 cmdlet 接受的返回类型(亦称为"输出类型"),请参阅 cmdlet 的输入和输出类型。 如果"输出类型"字段为空,则表明此 cmdlet 不返回任何数据。