New-CsBlockedDomain
上一次修改主题： 2012-03-23
将新域添加到阻止进行联盟的域列表。根据定义，不允许用户使用 Microsoft Lync Server 2010 应用程序与阻止的域中的人员通信；例如，用户不能使用 Microsoft Lync 2010 与在阻止列表中出现的域中拥有 SIP 帐户的任何人交换即时消息。
语法
New-CsBlockedDomain -Identity <XdsGlobalRelativeIdentity> [-Comment <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
New-CsBlockedDomain -Domain <String> [-Comment <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
详细说明
联盟是两个组织间建立信任关系以促进沟通的一种途径。建立联盟之后，两个组织中的用户可以相互发送即时消息，订阅状态通知以及使用 Lync 2010 等 SIP 应用程序进行彼此通信。Lync Server 2010 允许建立三种类型的联盟：1) 在您的组织与其他组织之间直接建立联盟；2) 在您的组织与公共提供商之间建立联盟；以及 3) 在您的组织与第三方宿主提供商之间建立联盟。
与其他组织建立直接联盟涉及多项任务。首先，必须启用运行 Lync Server 访问边缘服务的服务器以允许联盟。此外，另一个组织也必须启用与您的联盟；除非双方都同意联盟关系，否则无法建立联盟。
要建立联盟关系，可能还需要管理两个与联盟相关的列表：允许列表和阻止列表。允许列表代表您已选择要与其联盟的组织；如果某个域出现在允许列表中，则用户将能够与在该联盟域中拥有帐户的用户交换即时消息和状态信息（具体取决于配置设置）。相反，阻止列表表示明确禁止用户与之联盟的域；例如，从阻止的域发送的消息将自动被 Lync Server 2010 拒绝。
通过 New-CsBlockedDomain cmdlet，可以将域添加到阻止的域列表。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 New-CsBlockedDomain cmdlet：RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsBlockedDomain"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
必需 |
字符串 |
要添加到阻止列表中的域的完全限定域名 (FQDN)；例如“fabrikam.com”。可以使用 Identity 或 Domain 参数（但不能同时使用二者）来指定域名。如果使用 Identity，Domain 属性将设置为分配给 Identity 的值。如果使用 Domain，Identity 属性将设置为分配给 Domain 的值。 请注意，标识必须是唯一的：如果阻止列表或允许列表中已存在指定域，命令将会失败。 |
Comment |
可选 |
字符串 |
用于提供有关阻止的域的其他信息的可选字符串值。例如，可以添加 Comment 来说明域被阻止的原因。 |
Domain |
可选 |
字符串 |
要添加到阻止列表中的域的 FQDN（例如 fabrikam.com）。可以使用 Identity 或 Domain 参数（但不能同时使用二者）来指定域名。如果使用 Identity，Domain 属性将设置为分配给 Identity 的值。如果使用 Domain，Identity 属性将设置为分配给 Domain 的值。 请注意，域必须是唯一的：如果阻止列表或允许列表中已存在指定域，命令将会失败。 |
Force |
可选 |
开关参数 |
禁止显示运行此命令时可能出现的任何非严重错误消息。 |
InMemory |
可选 |
开关参数 |
创建对象引用，但并不作为永久性更改实际提交对象。如果将使用此参数调用的 cmdlet 的输出分配给一个变量，您可以更改对象引用的属性，然后通过调用与此 cmdlet 匹配的 Set- cmdlet 提交这些更改。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况（无需实际执行命令）。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
无。New-CsBlockedDomain 不接受通过管道传递的输入。
返回类型
创建 Microsoft.Rtc.Management.WritableConfig.Settings.Edge.BlockedDomain 对象的实例。
示例
-------------------------- 示例 1 --------------------------
New-CsBlockedDomain -Identity "fabrikam.com" -Comment "Blocked per Ken Myer."
在上述示例中，将向阻止的域列表中添加域 fabrikam.com。为执行此操作，调用带有 Identity 参数的 New-CsBlockedDomain；该参数分配有要阻止的域的名称。此外，还包括了 Comment 参数，以便为阻止的域添加注释。请注意，如果阻止列表或允许列表中已存在 fabrikam.com，此命令将会失败。
-------------------------- 示例 2 --------------------------
$x = New-CsBlockedDomain -Identity "fabrikam.com" -InMemory
$x.Comment = "Blocked per Ken Myer."
Set-CsBlockedDomain -Instance $x
示例 2 演示了如何使用 InMemory 参数创建一个最初仅存在于内存中的新阻止域。修改此仅存在于内存中的域的属性值后，即可调用 Set-CsBlockedDomain 将此域添加到阻止列表中。
为了执行此任务，该命令中的第一行使用 New-CsBlockedDomain 和 InMemory 参数创建 Identity 为 fabrikam.com 的阻止域。在创建之后，此虚拟域存储在变量 $x 中。
第二行修改此虚拟域的 Comment 属性。完成该操作后，第 3 行使用 Set-CsBlockedDomain cmdlet 将此虚拟域添加到阻止列表。如果不使用第 3 行，此虚拟域将仅存在于内存中，并且始终不会添加到阻止列表。一旦结束 Windows PowerShell 会话或删除变量 $x，此虚拟域将立即消失。