Get-CsAccessEdgeConfiguration
上一次修改主题： 2012-03-23
返回有关组织中运行访问边缘服务的计算机（也称为访问边缘服务器）的配置设置的信息。访问边缘服务器提供了一种方法，能让内部网络以外的用户与内部网络中的用户进行通信。
语法
Get-CsAccessEdgeConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsAccessEdgeConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>]
详细说明
访问边缘服务器（也可称为访问代理服务器）可以扩展 Microsoft Lync Server 2010 的功能，使未登录到内部网络的人员也可进行访问。例如，如果有远程用户（已经过身份验证）通过 Internet 而不是内部网络登录 Lync Server 2010，则需要设置访问边缘服务器。此外，如果要与另一个组织建立联盟，或要允许用户与具备公共即时消息服务（如 Yahoo!、AOL 或 MSN）的帐户持有者进行通信，则需要边缘服务器。访问边缘服务器位于外围网络中，用于为内部网络之内和之外的用户之间建立 SIP 连接并对该连接进行验证。
在 Lync Server 中，使用配置设置的单一全局集合管理访问边缘服务器。借助 Get-CsAccessEdgeConfiguration cmdlet 可以返回有关这些全局设置的信息。请注意，Get-CsAccessEdgeConfiguration 返回的属性值会发生变化，具体取决于为边缘服务器配置的路由类型。有关详细信息，请参阅 Set-CsAccessEdgeConfiguration 帮助主题。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Get-CsAccessEdgeConfiguration cmdlet：RTCUniversalUserAdmins、RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsAccessEdgeConfiguration"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
可选 |
Xds 标识 |
要返回的访问边缘配置设置的唯一标识符。由于这些设置只能存在单一全局实例，因此在调用 Get-CsAccessEdgeConfiguration 时无需包括 Identity。然而，您可以使用以下语法检索全局设置：-Identity global。 |
Filter |
可选 |
字符串 |
使您在指定要返回的访问边缘配置设置时能够使用通配符。因为这些设置只能存在单一全局实例，因此无需使用 Filter 参数。但如果愿意，也可以使用类似以下语法检索全局设置：-Identity "g*"。 |
LocalStore |
可选 |
开关参数 |
从中央管理存储的本地副本，而非中央管理存储本身检索访问边缘配置数据。 |
输入类型
无。Get-CsAccessEdgeConfiguration 不接受通过管道传递的输入。
返回类型
Get-CsAccessEdgeConfiguration 可返回 Microsoft.Rtc.Management.WritableConfig.Settings.Edge.DisplayAccessEdgeSettingsDnsSrvRouting 对象或 Microsoft.Rtc.Management.WritableConfig.Settings.Edge.DisplayAccessEdgeSettingsDefaultRoute 对象的实例。
示例
-------------------------- 示例 1 ------------------------
Get-CsAccessEdgeConfiguration
示例 1 演示了 Get-CsAccessEdgeConfiguration 的基本用法：调用此不带任何参数的 cmdlet 将返回访问边缘服务器实施的所有属性值。请注意，无需包括 Identity 或 Filter 参数，因为只有一组访问边缘服务器配置数据。
-------------------------- 示例 2 ------------------------
Get-CsAccessEdgeConfiguration | Select-Object Allow*
上述命令仅返回访问边缘服务器配置的三个属性值：AllowAnonymousUsers、AllowFederatedUsers 和 AllowOutsideUsers。为此，该命令首先使用 Get-CsAccessEdgeConfiguration 返回所有的访问边缘服务器属性值。然后将这些信息通过管道传递到 Select-Object cmdlet，后者仅挑选出以字符串值“Allow”开头的属性。接下来，屏幕上仅会显示这些属性值。
-------------------------- 示例 3 ------------------------
(Get-CsAccessEdgeConfiguration).EnablePartnerDiscovery
示例 3 中显示的命令将返回单个访问边缘服务器配置属性的值：EnablePartnerDiscovery。为此，首先调用 Get-CsAccessEdgeConfiguration 返回所有访问边缘服务器配置属性值。将对 Get-CsAccessEdgeConfiguration 的调用用括号括起来，这可以确保 Windows PowerShell 在完成此命令后才执行其他操作。在所有属性值都已返回后，使用标准“点标记”（对象名称后跟一个圆点，再跟属性名）显示单个属性的值：EnablePartnerDiscovery。