Removes a SIP domain previously configured 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.
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 removed: For example: -Identity fabrikam.com. |
|
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).
After a SIP domain has been authorized it can be "unauthorized" by using the Remove-CsSipDomain cmdlet. This cmdlet simply removes the specified domain from the list of approved SIP domains.
Return Types
Remove-CsSipDomain deletes existing instance of the Microsoft.Rtc.Management.Xds.SipDomain object.
Examples
-------------------------- Example 1 ------------------------
 Copy Code |
|
|---|---|
Remove-CsSipDomain -Identity fabrikam.com |
|
The preceding command removes the SIP domain with the Identity fabrikam.com from the list of supported domain names. Note that this command will fail if fabrikam.com is the only SIP domain currently in use in your organization. That’s because your Microsoft Communications Server 2010 topology must include at least one SIP domain.
-------------------------- Example 2 ------------------------
| Copy Code |
|
|---|---|
Get-CsSipDomain | Where-Object {$_.Default -ne $True} | Remove-CsSipDomain
|
|
The command shown in Example 2 deletes all the SIP domains in your organization except for the default domain. To do this, the command first calls Get-CsSIPDomain in order to return a collection of all your SIP domains. This collection is then piped to the Where-Object cmdlet, which picks out only those domains where the Default property is not equal to (-ne) True ($True). The net effect? The default domain is filtered out, and the remaining domains are then piped to Remove-CsSipDomain and deleted.