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