Parameters

In order to configure SIP addresses for your users (and thus enable them to use SIP-related software such as Microsoft Lync 2010), you need two pieces of information: a user ID (for example, Ken.Myer) and a SIP domain (for example, litwareinc.com). The SIP domain used to construct a SIP address must be a domain located within your Active Directory forest that is authorized to send and receive SIP traffic. For example, suppose you have domains named litwareinc.com, fabrikam.com, and contoso.com, but only litwareinc.com has been identified as being a SIP domain. In that case, you cannot use a SIP address like sip:Ken.Myer@fabrikam.com or sip:Ken.Myer@contoso.com, at least not until fabrikam.com and contoso.com have been configured as valid SIP domains. This is something you can do by running the New-CsSipDomain cmdlet.

The Get-CsSipDomain cmdlet provides a way for you to return information about the SIP domains authorized for use in your organization. Get-CsSipDomain also identifies the default SIP domain for your organization; this is the domain that Microsoft Lync Server 2010 will use, by default, if a SIP domain is not specified.

Who can run this cmdlet: By default, members of the following groups are authorized to run the Get-CsSipDomain cmdlet locally: RTCUniversalServerAdmins. To return a list of all the role-based access control (RBAC) roles this cmdlet has been assigned to (including any custom RBAC roles you have created yourself), run the following command from the Windows PowerShell prompt:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsSipDomain"}

None. Get-CsSipDomain does not accept pipelined data.

Get-CsSipDomain returns instances of the Microsoft.Rtc.Management.Xds.SipDomain object.

-------------------------- Example 1 ------------------------

	Copy Code
Get-CsSipDomain

In Example 1, Get-CsSipDomain is called without any parameters; this returns information about all the SIP domains configured for use in your organization.

-------------------------- Example 2 ------------------------

	Copy Code
Get-CsSipDomain -Identity fabrikam.com

The command shown in Example 2 returns information for any SIP domain that has the Identity fabrikam.com. Because SIP domain Identities must be unique, this command will never return more than a single item.

-------------------------- Example 3 ------------------------

	Copy Code
Get-CsSipDomain -Filter "f*"

The preceding command uses Get-CsSipDomain and the Filter parameter to return information about all the SIP domains that have an Identity that begins with the letter "f". For example: fabrikam.com; fabrikam.org; fabrikam-users.com; and so on.

-------------------------- Example 4 ------------------------

	Copy Code
Get-CsSipDomain | Where-Object {$_.IsDefault -eq $True}

The command shown in Example 4 returns information about the default SIP domain. To do this, Get-CsSipDomain is first called without any parameters in order to return a collection of all the SIP domains configured for use in your organization. This collection is then piped to the Where-Object cmdlet, which selects the one domain where the IsDefault property is equal to True.

Other Resources