Remove-CsMediaConfiguration
上次修改主題的時間： 2012-03-26
移除指定的媒體組態設定集合。
語法
Remove-CsMediaConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
詳細描述
此指令程式會移除媒體設定的集合。這些設定與用戶端端點間的音訊和視訊通話有關。
此指令程式也用來移除通用媒體設定。但在此情況下，不會實際移除設定；而只是重設為其預設值。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Remove-CsMediaConfiguration Cmdlet：RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsMediaConfiguration"}
參數
| 參數 | 必要 | 類型 | 說明 |
|---|---|---|---|
Identity |
必要 |
Xds 識別碼 |
您要移除之媒體組態設定的唯一識別碼。此識別碼會指定套用此組態的範圍 (通用、網站或服務)。 |
Force |
選用 |
切換參數 |
抑制在進行變更前可能顯示的任何確認提示。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
Microsoft.Rtc.Management.WritableConfig.Settings.Media.MediaSettings 物件。接受媒體組態物件的管線傳送資料。
傳回類型
移除 Microsoft.Rtc.Management.WritableConfig.Settings.Media.MediaSettings 類型的物件。
範例
-------------------------- 範例 1 --------------------------
Remove-CsMediaConfiguration -Identity site:Redmond1
在範例 1 中，Remove-CsMediaConfiguration 用來刪除 Identity 為 site:Redmond1 的媒體組態集合。從站台範圍中移除媒體設定時，該站台會自動開始使用通用媒體設定。
-------------------------- 範例 2 --------------------------
Get-CsMediaConfiguration | Where-Object {$_.EncryptionLevel -eq "RequireEncryption"} | Remove-CsMediaConfiguration
在前一個範例中，Get-CsMediaConfiguration、Where-Object 和 Remove-CsMediaConfiguration 這三個指令程式可用來移除參與交談的各方都需要加密的所有媒體組態集合。為此，首先使用 Get-CsMediaConfiguration 來傳回組織中的所有媒體組態集合。接著，將該資訊傳送給 Where-Object，由它套用篩選器將管線資料限制在 EncryptionLevel 屬性等於 (-eq) RequireEncryption 的集合。最後，篩選過的資料集會傳送給 Remove-CsMediaConfiguration，由它刪除資料集的每一個項目。
-------------------------- 範例 3 --------------------------
Get-CsMediaConfiguration -Filter service:* | Remove-CsMediaConfiguration
在此範例中，會移除在服務範圍上定義的所有媒體組態 (這表示組態會套用至特定服務)。在作法上是先使用 Filter service:* 來呼叫 Get-CsMediaConfiguration。此篩選會擷取 Identity 開頭為 service 的所有媒體組態集合，這表示在服務範圍上的所有集合。接著，這組集合會傳送給 Remove-CsMediaConfiguration，由它移除所有集合。