Enables you to change the default SIP domain for 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.
Syntax
add-attachmentfilterentry -Name <String> -Type <ContentType | FileName> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-WhatIf [<SwitchParameter>]] |
Parameters
| Parameter | Required | Type | Description |
|---|---|---|---|
|
Identity |
Required |
String |
Fully qualified domain name of the SIP domain to be configured as the default domain. For example: -Identity fabrikam.com. |
|
IsDefault |
Optional |
Boolean |
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 |
|
LocalStore |
Optional |
Switch Parameter |
This parameter is for testing purposes only. |
|
WhatIf |
Optional |
Switch Parameter |
Describes what would happen if you executed the command without actually executing the command. |
|
Confirm |
Optional |
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 (something you do by running the New-CsSipDomain cmdlet).
The Set-CsSipDomain cmdlet provides a way for you to change your default SIP domain. Note that this is the only SIP domain property that you can modify. If you change the name of a domain (e.g., if fabrikam.com becomes contoso.com) you cannot change the Identity of the SIP domain fabrikam.com. Instead, you will have to use Remove-CsSipDomain to delete fabrikam.com from the list of authorized domain, then call New-CsSipDomain in order to add contoso.com to the list.
Return Types
Set-CsSipDomain does not return any objects or values. Instead, the cmdlet is used to modify existing instances of the Microsoft.Rtc.Management.Xds.SipDomain object.
Examples
-------------------------- Example 1 ------------------------
 Copy Code |
|
|---|---|
Set-CsSipDomain -Identity fabrikam.com -IsDefault $True |
|
The command shown in Example 1 makes the SIP domain fabrikam.com the default SIP domain; this is done simply by using the –IsDefault parameter and the parameter value $True. When this command is run, Fabrikam.com will become the default domain, and the domain which previously served as the default will be "demoted." That’s because you can have only one default domain.