[This is preliminary documentation and is subject to change. Blank topics are included as placeholders.]

Creates a new SIP domain for use in your organization. SIP domains are domains authorized to send and receive SIP (Session Initiation Protocol) traffic, and are used when assigning SIP addresses to users.


add-attachmentfilterentry -Name <String> -Type <ContentType | FileName> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-WhatIf [<SwitchParameter>]]


Parameter Required Type Description




Full qualified domain name for the new SIP domain. For example: -Identity fabrikam.com.




Indicates whether the domain is the default SIP domain, the domain used by Communications Server any time a domain name is not explicitly stated. If set to True, the new domain will also become the new default domain

The default value for IsDefault is False. If you do not want to make the new domain the default domain you can include this parameter and parameter value: -IsDefault $False. Alternatively, you can simply leave out the parameter altogether.



Switch Parameter

This parameter is for testing purposes only.



Switch Parameter

Describes what would happen if you executed the command without actually executing the command.



Switch Parameter

Prompts you for confirmation before executing the command.

Detailed Description

In order to configure SIP addresses for your users (and thus enable them to use SIP-related software such as Microsoft Communicator) you must supply two pieces of information: a user ID (for example, Ken.Myer) and a SIP domain (for example, litwareinc.com). The SIP domains used in this SIP addresses must be domains located within your Active Directory forest; in addition, these domains must be specifically configured as domains authorized to send and receive SIP traffic. For example, supposed 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 SIP address like sip:Ken.Myer@fabrikam.com or sip:Ken.Myer@contoso.com, at least not until fabrikam.com and contoso.com has been configured as valid SIP domains.

If you need to authorize additional SIP domains you can do so using the New-CsSipDomain cmdlet.

Return Types

New-CsSipDomain creates new instances of the Microsoft.Rtc.Management.Xds.SipDomain object.


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

Copy Code
New-CsSipDomain -Identity fabrikam.com

The command shown in Example 1 creates a new SIP domain, one that has the Identity fabrikam.com.

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

Copy Code
New-CsSipDomain -Identity fabrikam.com -IsDefault $True

The preceding command creates a new SIP domain named fabrikam.com, and makes this new domain the default SIP domain. In addition, this command will also "demote" the domain that previously served as the default SIP domain; that’s because you can have only one default SIP domain.