Set-CsSipDomain
上一次修改主题： 2012-03-27
使您可以修改组织中 SIP 域的属性值。SIP 域是有权发送和接收 SIP 通信的域，用于向用户分配 SIP 地址。
语法
Set-CsSipDomain [-Identity <XdsGlobalRelativeIdentity>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-IsDefault <$true | $false>] [-WhatIf [<SwitchParameter>]]
详细说明
要为您的用户配置 SIP 地址（从而使其可以使用与 SIP 相关的软件，如 Microsoft Lync 2010），需要以下两条信息：用户 ID（例如，Ken.Myer）和 SIP 域（例如，litwareinc.com）。用于构造 SIP 地址的 SIP 域必须是一个位于 Active Directory 林中的域，即有权发送和接收 SIP 通信的域。例如，假设您具有名为 litwareinc.com、fabrikam.com 和 contoso.com 的域，但只有 litwareinc.com 标识为 SIP 域。在这种情况下，至少将 fabrikam.com 和 contoso.com 配置为有效的 SIP 域后，您才能使用诸如 sip:Ken.Myer@fabrikam.com 或 sip:Ken.Myer@contoso.com 等 SIP 地址。此操作可以通过运行 New-CsSipDomain cmdlet 来执行。
必须始终将一个 SIP 域配置为默认域。Set-CsSipDomain cmdlet 提供了一种更改默认 SIP 域的方法。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Set-CsSipDomain cmdlet：RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsSipDomain"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
必需 |
字符串 |
要配置为默认域的 SIP 域的完全限定域名 (FQDN)。例如：-Identity fabrikam.com。 |
IsDefault |
可选 |
布尔值 |
指示域是否为默认 SIP 域，即在未显式声明域名时 Lync Server 2010 所使用的域。如果设置为 True，则新域将成为新的默认域。您不能将此值设置为 False，因为这将导致您缺少默认 SIP 域。 |
Force |
可选 |
开关参数 |
禁止显示运行此命令时可能出现的任何非严重错误消息。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况（无需实际执行命令）。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
无。Set-CsSipDomain 不接受通过管道传递的数据。
返回类型
Set-CsSipDomain 不返回任何对象或值。此 cmdlet 用于修改 Microsoft.Rtc.Management.Xds.SipDomain 对象的现有实例。
示例
-------------------------- 示例 1 --------------------------
Set-CsSipDomain -Identity fabrikam.com -IsDefault $True
示例 1 中显示的命令使 SIP 域 fabrikam.com 成为默认 SIP 域；这是通过使用 IsDefault 参数和参数值 $True 实现的。运行此命令后，Fabrikam.com 将成为默认域，并将以前作为默认域的域“降级”。这是因为只能有一个默认域。