Set-CsAllowedDomain
上一次修改主题： 2012-03-27
修改已批准可进行联盟的域列表中的一个或多个域的属性值。批准可以与某个域联盟（通过将域添加到允许列表）后，您的用户可以与拥有联盟域帐户的人交换即时消息和状态信息。
语法
Set-CsAllowedDomain [-Identity <XdsGlobalRelativeIdentity>] [-Comment <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-MarkForMonitoring <$true | $false>] [-ProxyFqdn <String>] [-WhatIf [<SwitchParameter>]]
Set-CsAllowedDomain [-Comment <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-MarkForMonitoring <$true | $false>] [-ProxyFqdn <String>] [-WhatIf [<SwitchParameter>]]
详细说明
联盟是两个组织间建立信任关系以促进沟通的一种途径。建立联盟之后，两个组织中的用户可以相互发送即时消息，订阅状态通知以及使用 Microsoft Lync 2010 等 SIP 应用程序进行彼此通信。Microsoft Lync Server 2010 允许建立三种类型的联盟：1) 在您的组织与其他组织之间直接建立联盟；2) 在您的组织与公共提供商之间建立联盟；以及 3) 在您的组织与第三方宿主提供商之间建立联盟。
与其他组织建立直接联盟涉及多项任务。首先，必须启用运行 Lync Server 访问边缘服务的服务器以允许联盟。此外，另一个组织也必须启用与您的联盟；除非双方都同意联盟关系，否则无法建立联盟。
要设置联盟关系，可能还需要管理两个与联盟相关的列表：允许列表和阻止列表。允许列表代表您已选择要与其联盟的组织。如果某个域出现在允许列表中，则您的用户将能够与在该联盟域中拥有帐户的用户交换即时消息和状态信息（具体取决于配置设置）。相反，阻止列表表示明确禁止用户与之联盟的域；例如，从阻止的域发送的消息将自动被 Lync Server 2010 拒绝。
Set-CsAllowedDomain cmdlet 提供了一种修改允许域列表中任何域的属性值的方法。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Set-CsAllowedDomain cmdlet：RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsAllowedDomain"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
必需 |
字符串 |
要修改其属性值的允许域的完全限定域名 (FQDN)。例如： -Identity fabrikam.com |
Instance |
可选 |
阻止域对象 |
允许您将对对象的引用传递到 cmdlet，而不是设置单个参数值。 |
Comment |
可选 |
字符串 |
提供有关要修改的域的其他信息的可选字符串值。例如，可能会添加提供联盟域的联系人信息的 Comment。 |
MarkForMonitoring |
可选 |
布尔值 |
指示您的域和远程域之间的联盟连接是否受监控服务器监控。默认情况下，MarkForMonitoring 设置为 False，意味着此连接不受监控。 如果尚未部署监控服务器，则会忽略此属性。 |
ProxyFqdn |
可选 |
Fqdn |
在要添加到允许列表中的域中部署的 SIP 代理服务器的完全限定域名，例如 proxy-server.fabrikam.com。此属性是可选的：如果未指定，则将使用 DNS SRV 发现过程来确定 SIP 代理服务器的位置。 |
Force |
可选 |
开关参数 |
禁止显示运行此命令时可能出现的任何非严重错误消息。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况（无需实际执行命令）。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
Microsoft.Rtc.Management.WritableConfig.Settings.Edge.AllowedDomain 对象。Set-CsAllowedDomain 接受通过管道传递的允许域对象的实例。
返回类型
Set-CsAllowedDomain 不会返回值或对象。此 cmdlet 会配置 Microsoft.Rtc.Management.WritableConfig.Settings.Edge.AllowedDomain 对象的实例。
示例
-------------------------- 示例 1 --------------------------
Set-CsAllowedDomain -Identity fabrikam.com -Comment "Contact: Ken Myer (kenmyer@fabrikam.com)"
示例 1 中显示的命令修改 Identity 为“fabrikam.com”的允许域的 Comment 属性。这是通过包含 Comment 参数和下面相应的参数值来实现的："Contact:Ken Myer (kenmyer@fabrikam.com)"。
-------------------------- 示例 2 --------------------------
Get-CsAllowedDomain -Filter *fabrikam* | Set-CsAllowedDomain -Comment "Contact: Ken Myer (kenmyer@fabrikam.com)" -MarkForMonitoring $True
上述命令修改 Identity 中包含字符串值“fabrikam”的所有允许域的 Comment 属性和 MarkForMonitoring 属性。为完成此任务，该命令首先调用带有 Filter 参数的 Get-CsAllowedDomain。筛选器值“*fabrikam*”指示 Get-CsAllowedDomain 返回 Identity 包含字符串值“fabrikam”的所有域。（例如，此命令可返回诸如 fabrikam.com、us.fabrikam.net 和 fabrikam-users.org 等的域。）然后，将筛选出的集合通过管道传递到 Set-CsAllowedDomain，后者将修改 Comment 属性，并将该集合中每一项的 MarkForMonitoring 属性值设置为 True ($True)。
-------------------------- 示例 3 --------------------------
Get-CsAllowedDomain | Where-Object {$_.MarkForMonitoring -eq $False} | Set-CsAllowedDomain -MarkForMonitoring $True
示例 3 中显示的命令修改允许列表上当前不受监控服务器监控的所有域。（即 MarkForMonitoring 属性设置为 False 的所有域。）为执行此操作，调用不带其他任何参数的 Get-CsAllowedDomain，以检索允许列表上的所有域的集合。将该集合通过管道传递到 Where-Object cmdlet，后者仅选择 MarkForMonitoring 等于 False 的域。然后，将筛选出的集合通过管道传递到 Set-CsAllowedDomain，后者将该集合中每个域的 MarkForMonitoring 属性设置为 True。
-------------------------- 示例 4 --------------------------
Get-CsAllowedDomain | Where-Object {$_.Comment -eq $Null} | Set-CsAllowedDomain -Comment "Need contact information."
示例 4 为允许列表中当前未设置 Comment 属性值的每个域添加一般性注释（“Need contact information.”）。为完成此任务，该命令首先调用 Get-CsAllowedDomain 以检索允许列表上所有域的集合。然后，将该集合通过管道传递到 Where-Object，后者仅挑选出 Comment 属性等于空值的域。接下来，将筛选出的集合通过管道传递到 Set-CsAllowedDomain，后者将修改该集合中每一项的 Comment 属性。