Get-CsSipDomain
上一次修改主题： 2012-03-23
返回有关配置为在组织中使用的 SIP 域的信息。SIP 域是有权发送和接收 SIP 通信的域，用于向用户分配 SIP 地址。
语法
Get-CsSipDomain [-Identity <XdsGlobalRelativeIdentity>]
Get-CsSipDomain [-Filter <String>]
详细说明
要为您的用户配置 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 来执行。
Get-CsSipDomain cmdlet 提供了一种返回有关授权在组织中使用的 SIP 域的信息的方法。Get-CsSipDomain 还可以为组织标识默认 SIP 域，默认情况下，如果未指定 SIP 域，Microsoft Lync Server 2010 将使用此 SIP 域。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Get-CsSipDomain cmdlet：RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsSipDomain"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
可选 |
字符串 |
要返回的 SIP 域的完全限定域名 (FQDN)（例如，fabrikam.com）。如果未指定此参数和 Filter 参数，则会返回所有授权在组织中使用的 SIP 域。 |
Filter |
可选 |
字符串 |
使您可以使用通配符指定要返回的一个或多个 SIP 域的 Identity。例如，筛选器值“*.org”会返回 Identity 以字符串值“.org”结尾的所有授权 SIP 域的集合。 |
输入类型
无。Get-CsSipDomain 不接受通过管道传递的数据。
返回类型
Get-CsSipDomain 返回 Microsoft.Rtc.Management.Xds.SipDomain 对象的实例。
示例
-------------------------- 示例 1 --------------------------
Get-CsSipDomain
在示例 1 中，调用了不带任何参数的 Get-CsSipDomain，这将返回有关配置为在组织中使用的所有 SIP 域的信息。
-------------------------- 示例 2 --------------------------
Get-CsSipDomain -Identity fabrikam.com
示例 2 中显示的命令返回 Identity 为 fabrikam.com 的任何 SIP 域的信息。由于 SIP 域的 Identity 必须是唯一的，因此此命令只会返回一项。
-------------------------- 示例 3 --------------------------
Get-CsSipDomain -Filter "f*"
上述命令使用 Get-CsSipDomain 和 Filter 参数返回有关 Identity 以字母“f”开头的所有 SIP 域的信息。例如：fabrikam.com、fabrikam.org、fabrikam-users.com 等。
-------------------------- 示例 4 --------------------------
Get-CsSipDomain | Where-Object {$_.IsDefault -eq $True}
示例 4 中显示的命令返回有关默认 SIP 域的信息。为执行此操作，首先调用不带任何参数的 Get-CsSipDomain，以返回配置为在组织中使用的所有 SIP 域的集合。然后，将该集合通过管道传递到 Where-Object cmdlet，后者会选择 IsDefault 属性等于 True 的一个域。