Removes one or more of the Simple URL configuration collections currently in use in your organization. Simple URLs make it easier for users to join meetings and conferences, as well as making it easier for Administrators to log on to the Communications Server Control Panel.
Syntax
Remove-CsSimpleUrlConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Tenant <Nullable>] [-WhatIf [<SwitchParameter>]] |
Parameters
| Parameter | Required | Type | Description |
|---|---|---|---|
|
Identity |
Required |
Xds Identity |
Unique identifier for the collection of Simple URLs to be removed. To remove a collection from the site scope, use syntax similar to this: -Identity "site:Redmond." Note that you cannot use wildcards when specifying an Identity. You can also use this syntax to "remove" the global collection: -Identity global. In that case, however, the global collection will not be deleted. Instead, all the Simple URLs within that collection will be deleted. |
|
Force |
Optional |
Switch Parameter |
Suppresses the display of any non-fatal error message that might arise when running the command. |
|
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 Office Communications Server 2007 R2, online meetings had URLs similar to this:
https://imdf.litwareinc.com/Join?uri=sip%3Akenmyer%40litwareinc.com%3Bgruu%3Bopaque%3Dapp%3Aconf%3Afocus%3Aid%3A125f95a0b0184dcea706f1a0191202a8&key=EcznhLh5K5t
Needless to say, URLs such as that one are not especially intuitive, and not easy to convey to someone else. The Simple URLs introduced in Microsoft Communications Server “14” help overcome those problems by providing users with URLs that look more like this:
https://meet.litwareinc.com/071200
Simple URLs are obviously an improvement over the URLs used in the previous version of Office Communications Server. However, Simple URLs are not automatically created for you; instead, you must configure the URLs yourself. (You must also create DNS records for each URL; see the Microsoft Communications Server “14” Deployment Guide for more information.)
Communications Server “14” enables you to create three different Simple URLs:
Meet – Used for online meetings. You must have at least one Meet URL for each of your SIP domains.
Admin – Used to point administrators towards the Communications Server Control Panel.
Dialin – Used for dial-in conferencing.
Simple URLs are stored in Simple URL configuration collections. When you install Communications Server, a global collection is created for you; you can also create custom collections at the site scope. This gives you the ability to use different Simple URLs at each of your sites.
Simple URL configuration collections are created using the New-CsSimpleUrlConfiguration cmdlet; you can then use additional cmdlets (such as New-CsSimpleUrlEntry and Set-CsSimpleUrlConfiguration) to populate these collections with Simple URLs. If you later decide to delete one or more of the site-scoped collections, you can do so by using the Remove-CsSimpleUrlConfiguration.
Return Types
Remove-CsSimpleUrlConfiguration deletes instances of the Microsoft.Rtc.Management.WriteableConfig.Settings.SimpleUrl.SimpleUrlConfiguration object.
Examples
-------------------------- Example 1 ------------------------
 Copy Code |
|
|---|---|
Remove-CsSimpleUrlConfiguration -Identity "site:Redmond" |
|
The command shown in Example 1 deletes the Simple URL configuration collection applied to the Redmond site. This command deletes all the Simple URLs assigned to the specified site.
-------------------------- Example 2 ------------------------
| Copy Code |
|
|---|---|
Get-CsSimpleUrlConfiguration -Filter "site:*" | Remove-CsSimpleUrlConfiguration |
|
In Example 2, all the Simple URL configuration collections applied at the site scope are deleted. To do this, the command first uses Get-CsSimpleUrlConfiguration and the –Filter parameter to return all the Simple URL collections configured at the site scope; the filter value "site:*" limits the returned data to those collections that have an Identity that begins with the string value "site:". The filtered collection is then piped to Remove-CsSimpleUrlConfiguration, which deletes each item in that collection.