Get-CsMediaConfiguration
上次修改主題的時間： 2012-03-23
傳回與媒體設定相關的資訊，包括支援的加密層級、中繼伺服器與 Microsoft Lync 2010 用戶端的互動中是否可以使用 Siren 做為語音轉碼器，以及允許的視訊解析度上限。
語法
Get-CsMediaConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsMediaConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>]
詳細描述
此指令程式會擷取一或多個定義媒體互動之設定的集合。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Get-CsMediaConfiguration Cmdlet：RTCUniversalUserAdmins、RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsMediaConfiguration"}
參數
| 參數 | 必要 | 類型 | 說明 |
|---|---|---|---|
Identity |
選用 |
Xds 識別 |
您要擷取之媒體組態的唯一識別碼。此識別碼會指定套用此組態的範圍 (通用、網站或服務)。 |
Filter |
選用 |
字串 |
此參數會根據傳遞給此參數的萬用字元值，篩選 Get 作業的結果。 |
LocalStore |
選用 |
切換參數 |
從中央管理存放區的本機複本擷取媒體組態資訊，而非從中央管理存放區本身擷取。 |
輸入類型
無。
傳回類型
Get-CsMediaConfiguration 傳回 Microsoft.Rtc.Management.WritableConfig.Settings.Media.MediaSettings 物件的執行個體。
範例
-------------------------- 範例 1 --------------------------
Get-CsMediaConfiguration
範例 1 只需叫用 Get-CsMediaConfiguration 指令程式且不需其他任何參數，即可傳回組織中使用的所有媒體組態。
-------------------------- 範例 2 --------------------------
Get-CsMediaConfiguration -Identity site:Redmond1
前一個範例只傳回 Identity 為 site:Redmond1 的媒體組態。因為識別身分必須是唯一的，指定 Identity 可確保您絕對不會擷取多個項目。
-------------------------- 範例 3 --------------------------
Get-CsMediaConfiguration -Filter site:*
在範例 3 中，Filter 參數可用來傳回在網站範圍的所有媒體組態。萬用字元字串 site:* 可確保 Windows PowerShell 只傳回識別身分開頭為字串值 site: 的媒體組態。
-------------------------- 範例 4 --------------------------
Get-CsMediaConfiguration | Where-Object {$_.EncryptionLevel -eq "SupportEncryption"}
在此範例中，Get-CsMediaConfiguration 和 Where-Object 用來傳回支援 (但不需要) 加密的所有媒體組態。作法為命令先使用 Get-CsMediaConfiguration 來擷取組織中使用的所有媒體組態。接著，將此資訊傳送給 Where-Object 指令程式，以套用篩選，將傳回的資料限於 EncryptionLevel 屬性等於 (-eq) SupportEncryption 的組態。
-------------------------- 範例 5 --------------------------
Get-CsMediaConfiguration -Filter *:*med*
此範例會擷取名稱含有 "med" 字串的網站和服務已定義的所有媒體組態。例如，此命令會擷取針對網站 medford1、網站 TwoMedfordPlace 以及服務 MediationServer:redmond.litwareinc.com 定義的媒體組態設定。