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

Creates a new Simple URL entry, an element needed when creating a Simple URL. 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

New-CsSimpleUrlEntry -Url <String>

Parameters

Parameter Required Type Description

Url

Required

String

URL to be added to the SimpleUrlEntry property of a Simple URL. For example: -Url "https://meet.litwareinc.com". URLs must start with the https: prefix.

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.

To add an actual URL to a Simple URL collection you must first create the URL using the New-CsSimpleUrl and the New-CsSimpleUrlEntry cmdlets. The New-CsSimpleUrlEntry cmdlet creates a URL entry; this is nothing more than a URL (such as https://meet.litwareinc.com) that can be used as a Simple URL (for meeting, administration, or dial-in conferencing purposes). The object created by New-CsSimpleUrlEntry is then added to the SimpleUrlEntry property of a new Simple URL. You must use a separate cmdlet to create the object because the SimpleUrlEntry property can hold multiple URLs. (However, only one such URL can be designated as the active URL. The active URL represents the actual URL used for meetings, administration, or dial-in conferencing.)

After creating a Simple URL entry, you then use the New-CsSimpleUrl cmdlet to create an in-memory-only instance of a Simple URL, defining such things as the component (the type of Simple URL), the domain, the active URL, and all of the Simple URL entries. After you have created an object representing the Simple URL, that object can then be added to a new (or existing) Simple URL collection.

Return Types

New-CsSimpleUrlEntry creates new instances of the Microsoft.Rtc.Management.WriteableConfig.SimpleUtl.SimpleUrlEntry object.

Examples

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

Copy Code
$urlEntry = New-CsSimpleUrlEntry -Url "https://meet.litwareinc.com"

$simpleUrl = New-CsSimpleUrl -Component "meet" -Domain "litwareinc.com" -SimpleUrl $urlEntry -ActiveUrl "https://meet.litwareinc.com"

Set-CsSimpleUrlConfiguration -Identity global -SimpleUrl @{Add=$simpleUrl}

The preceding example shows how a new URL can be added to an existing collection of Simple URLs. To begin with, the first command in the example uses New-CsSimpleUrlEntry to create a URL entry that points to https://meet.litwareinc.com; this URL entry is stored in a variable named $urlEntry.

In the second command, New-CsSimpleUrl is used to create an in-memory-only instance of a Simple URL. In this example, the URL Component is set to Meet; the domain is set to litwareinc.com; the ActiveUrl is set to https://meet.litwareinc.com; and the SimpleUrl property is set to $urlEntry, $urlEntry being the URL entry created in the first command.

After the URL has been created (and stored in the object reference $simpleUrl) the final command in the example adds the new URL to the Simple URL collection for the Redmond site. This is done by using the –SimpleUrl parameter and the parameter value @{Add=$simpleUrl}. This syntax simply says that the URL stored in the object reference $simpleUrl should be added to the SimpleUrl property.

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

Copy Code
$urlEntry = New-CsSimpleUrlEntry -Url "https://meet.litwareinc.com"
$urlEntry2 = New-CsSimpleUrlEntry -Url "https://litwareinc.com/meet"

$simpleUrl = New-CsSimpleUrl -Component "meet" -Domain "litwareinc.com" -SimpleUrl $urlEntry,$urlEntry2 -ActiveUrl "https://meet.litwareinc.com"

Set-CsSimpleUrlConfiguration -Identity global -SimpleUrl ${Add=$simpleUrl}

In Example 2, a pair of URL entries are added to an existing collection of Simple URLs. To do this, the first command in the example uses New-CsSimpleUrlEntry to create a URL entry that points to https://meet.litwareinc.com; this URL entry is stored in a variable named $urlEntry. The second command then creates a second URL entry, this one stored in the variable $urlEntry2 and pointing to the URL https://litwareinc.com/meet.

After the two URL entries have been created, New-CsSimpleUrl is used to create an in-memory-only instance of a Simple URL. In this example, the URL Component is set to Meet; the domain is set to litwareinc.com; and the ActiveUrl is set to https://meet.litwareinc.com. In addition, both URL entry object references ($urlEntry and $urlEntry2) are assigned to the SimpleUrl property; that’s what the syntax "–SimpleUrl $urlEntry, $urlZEntry2" is for. The net result is that the new Simple URL will contain two URLs: one pointing to https://meet.litwareinc.com and the other pointing to https://litwareinc.com/meet. However, only the only URL available to users will be https://meet.litwareinc.com; that’s because this has been designated as the active URL. To use the URL https://litwareinc.com/meet instead, you must configure that URL as the active URL.

After the URL has been created (and stored in the object reference $simleUrl) the final command in the example adds the new URL to the Simple URL collection for the Redmond site. This is done by using the –SimpleUrl parameter and the parameter value @{Add=$simpleUrl}. This syntax simply says that the URL stored in the object reference $simpleUrl should be added to the SimpleUrl property.