Get-CsSimpleUrlConfiguration

Returns information about the simple URLs configured for use in your organization. Simple URLs make it easier for users to join meetings and conferences, and also make it easier for Administrators to log on to the Skype for Business Server Control Panel. This cmdlet was introduced in Lync Server 2010.

Syntax

Get-CsSimpleUrlConfiguration
   [[-Identity] <XdsIdentity>]
   [-Tenant <Guid>]
   [-LocalStore]
   [<CommonParameters>]
Get-CsSimpleUrlConfiguration
   [-Filter <String>]
   [-Tenant <Guid>]
   [-LocalStore]
   [<CommonParameters>]

Description

In Microsoft Office Communications Server 2007 R2, 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

However, such URLs are not especially intuitive, and not easy to convey to someone else. The simple URLs introduced in Lync Server 2010 helped overcome those problems by providing users with URLs that look more like this:

https://meet.litwareinc.com/kenmyer/071200

Simple URLs are an improvement over the URLs used in Office Communications Server. However, simple URLs are not automatically created for you; instead, you must configure the URLs yourself. (You must also create Domain Name System (DNS) records for each URL; configure reverse proxy rules for external access; add the simple URLs to your Front End Server certificates; and so on.)

Skype for Business Server enables you to create three different simple URLs:

Meet - Used for meetings. You must have at least one Meet URL for each of your SIP domains.

Admin - Used to point administrators toward the Skype for Business Server Control Panel.

Dialin - Used for the dial-in conferencing webpage.

Simple URLs are stored in simple URL configuration collections. When you install Skype for Business 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.

The Get-CsSimpleUrlConfiguration cmdlet provides a way for you to retrieve information about all the simple URL configuration collections currently in use in your organization.

Examples

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

Get-CsSimpleUrlConfiguration

Example 1 returns information about all the simple URL configuration collections currently in use in the organization. This is achieved by calling the Get-CsSimpleUrlConfiguration cmdlet without any additional parameters.

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

Get-CsSimpleUrlConfiguration -Identity "site:Redmond"

In Example 2, information is returned for a single simple URL configuration collection: the configuration with the Identity site:Redmond.

-------------------------- Example 3 --------------------------

Get-CsSimpleUrlConfiguration -Filter "site:*"

Example 3 returns information for all the simple URL configuration collections that have been assigned to the site scope. To do this, the Get-CsSimpleUrlConfiguration cmdlet is called along with the Filter parameter; the filter value "site:*" limits the returned data to those collections that have an Identity that begins with the string value "site:".

-------------------------- Example 4 --------------------------

Get-CsSimpleUrlConfiguration | Select-Object -ExpandProperty SimpleUrl

In Example 4, detailed information is displayed for each simple URL configured for use in the organization. To carry out this task, the command first calls the Get-CsSimpleUrlConfiguration cmdlet to return a complete set of simple URL information. This data is then piped to the Select-Object cmdlet, which uses the ExpandProperty parameter to "expand" the value of the SimpleUrl property. Expanding a property value displays all the data stored in that property in an easy-to-read format.

-------------------------- Example 5 --------------------------

Get-CsSimpleUrlConfiguration | Select-Object -ExpandProperty SimpleUrl | Where-Object {$_.Component -eq "Meet"}

The command shown in Example 5 returns all the simple URLs for meeting management that are currently in use in your organization. To do this, the command first calls the Get-CsSimpleUrlConfiguration cmdlet without any additional parameters; this returns a complete set of simple URL information. This data is then piped to the Select-Object cmdlet, which uses the ExpandProperty parameter to expand the value of the SimpleUrl property. The filtered collection is then piped to the Where-Object cmdlet, which picks out only those simple URLs where the Component property is equal to "Meet".

Parameters

-Filter

Enables you to use wildcard characters to specify the simple URL collection (or collections) to be returned. For example, this syntax returns all the simple URL collections that have been configured at the site scope:

-Filter "site:*"

Note that you cannot use both the Filter and the Identity parameters in the same command.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019

-Identity

Unique identifier for the collection of simple URLs to be returned. To return the global collection, use this syntax:

-Identity global

To return a collection from the site scope, use syntax similar to this:

-Identity "site:Redmond"

Note that you cannot use wildcards when specifying an Identity. If you want to use wildcards, use the Filter parameter instead.

Calling the Get-CsSimpleUrlConfiguration cmdlet without any parameters returns all the simple URLs configured for use in your organization.

Type:XdsIdentity
Position:2
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019

-LocalStore

Retrieves the simple URL configuration data from the local replica of the Central Management store rather than from the Central Management store itself.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019

-Tenant

Globally unique identifier (GUID) of the Skype for Business Online tenant account where whose Simple URL configuration settings are to be retrieved. For example:

-Tenant "38aad667-af54-4397-aaa7-e94c79ec2308"

You can return the tenant ID for each of your tenants by running this command:

Get-CsTenant | Select-Object DisplayName, TenantID

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019

Inputs

None

Outputs

Microsoft.Rtc.Management.WritableConfig.Settings.SimpleUrl.SimpleUrlConfiguration