Example 1

The command shown in Example 1 sets the internal service URL for the global collection of tenant hybrid configuration settings. To configure a global setting, include the Identity parameter along with the parameter value "global".

	Copy Code
Set-CsTenantHybridConfiguration -Identity "global" - HybridConfigServiceInternalUrl "https://internal.litwareinc.com"

Example 2

In Example 2, the internal service URL is configured for a specific tenant; in this example, the tenant that has the TenantID "bf19b7db-6960-41e5-a139-2aa373474354". When a property value is explicitly assigned to an individual tenant, the tenant will be governed by their individual tenant hybrid configuration settings instead of the global settings.

	Copy Code
Set-CsTenantHybridConfiguration -Tenant "bf19b7db-6960-41e5-a139-2aa373474354" HybridConfigServiceInternalUrl "https://internal.litwareinc.com"

Example 3

The command shown in Example 3 configures the internal service URL for all of your organization's tenants. To do this, the command first uses the Get-CsTenant cmdlet to return a collection of all the available tenants; that collection is then piped to the ForEach-Object cmdlet. In turn, the ForEach-Object cmdlet runs the Set-CsTenantHybridConfiguration cmdlet against each tenant in the collection, setting the internal service URL for each of those tenants to "https://internal.litwareinc.com".

	Copy Code
Get-CsTenant | ForEach-Object {Set-CsTenantHybridConfiguration -Tenant $_.TenantID -HybridConfigServiceInternalUrl "https://internal.litwareinc.com"}

In a hybrid or "split domain" deployment, an organization has some users who have accounts homed on Lync Online while simultaneously having other users who have accounts homed on Lync Server. By default, users homed on Lync Online do not have access to the complete range of capabilities offered by Enterprise Voice; that's because the Lync Online servers do not have direct access to on-premises Lync Server deployment and network configuration information. Among other things, Lync Online users do not have default access to such things as:

• Enhanced 9-1-1, the Lync Server service used for making emergency phone calls.

• Call parking, the Lync Server service which enables users to place a call on hold phone A, then retrieve that call from phone B.

• Media bypass, which enables calls to and from the public switched telephone network (PSTN) to bypass the Mediation server, helping to minimize transcoding and network latency.

• PSTN conferencing dial-in and dial-out, which enables users to participate in the audio portion of an online conference by using any PSTN telephone or mobile device.

• The Response Group application, which provides a way for you to automatically route phone calls to entities such as a help desk or customer support line. By default, Lync Online users cannot function as Response Group agents.

In order to provide Lync Online users with access to these Enterprise Voice capabilities, administrators need to assign the appropriate values to hybrid configuration settings such as the internal and external Web service URLs and the fully qualified domain name of the organization's Access Edge server. These values, which can only be configured by using the Set-CsTenantHybridConfiguration cmdlet, provide the Lync Online servers with the information needed to make use of these advanced Enterprise Voice features.

None. The Set-CsTenantHybridConfiguration cmdlet does not accept pipelined input.

None. Instead, the Set-CsTenantHybridConfiguration cmdlet modifies existing instances of the Microsoft.Rtc.Management.WritableConfig.Settings.HybridConfiguration.TenantHybridConfiguration object.