Parameters

This cmdlet retrieves one or more collections of settings that define media interactions.

Who can run this cmdlet: By default, members of the following groups are authorized to run the Get-CsMediaConfiguration cmdlet locally: RTCUniversalUserAdmins, RTCUniversalServerAdmins. To return a list of all the role-based access control (RBAC) roles this cmdlet has been assigned to (including any custom RBAC roles you have created yourself), run the following command from the Windows PowerShell prompt:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsMediaConfiguration"}

None.

Get-CsMediaConfiguration returns instances of the Microsoft.Rtc.Management.WritableConfig.Settings.Media.MediaSettings object.

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

	Copy Code
Get-CsMediaConfiguration

Example 1 returns all the media configurations in use in your organization; this is done simply by invoking the cmdlet Get-CsMediaConfiguration without any additional parameters.

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

	Copy Code
Get-CsMediaConfiguration -Identity site:Redmond1

The preceding example returns only the media configuration that has the Identity site:Redmond1. Because identities must be unique, specifying an Identity ensures that you will never retrieve more than one item.

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

	Copy Code
Get-CsMediaConfiguration -Filter site:*

In Example 3, the Filter parameter is used to return all the media configurations at the site scope. The wildcard string site:* ensures that Windows PowerShell will return only those media configurations that have identities beginning with the string value site:.

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

	Copy Code
Get-CsMediaConfiguration | Where-Object {$_.EncryptionLevel -eq "SupportEncryption"}

In this example, Get-CsMediaConfiguration and Where-Object are used to return all the media configurations that support (but do not require) encryption. To do this, the command first uses Get-CsMediaConfiguration to retrieve all the media configurations in use in your organization. This information is then piped to the Where-Object cmdlet, which applies a filter that restricts the returned data to those configurations where the EncryptionLevel property is equal to (-eq) SupportEncryption.

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

	Copy Code
Get-CsMediaConfiguration -Filter *:*med*

This example retrieves all media configurations defined for sites and services with names that contain the string "med". For example, this command will retrieve media configuration settings defined for the site medford1, the site TwoMedfordPlace, and the service MediationServer:redmond.litwareinc.com.

Other Resources