Remove-CsMediaConfiguration
Letztes Änderungsdatum des Themas: 2012-03-26
Entfernt die angegebene Auflistung der Medienkonfigurationseinstellungen.
Syntax
Remove-CsMediaConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Detaillierte Beschreibung
Mit diesem Cmdlet wird eine Auflistung von Medieneinstellungen entfernt. Diese Einstellungen beziehen sich auf Audio- und Videoanrufe zwischen Clientendpunkten.
Dieses Cmdlet kann zudem zum Entfernen der globalen Medieneinstellungen verwendet werden. In diesem Fall werden die Einstellungen jedoch nicht wirklich entfernt, sondern einfach auf ihre Standardwerte zurückgesetzt.
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig sind Mitglieder der folgenden Gruppen autorisiert, das Cmdlet Remove-CsMediaConfiguration lokal auszuführen: RTCUniversalServerAdmins. Geben Sie den folgenden Befehl an der Windows PowerShell-Eingabeaufforderung ein, um eine Liste aller rollenbasierten Zugriffssteuerungsrollen zurückzugeben, die diesem Cmdlet zugewiesen wurden (einschließlich der benutzerdefinierten rollenbasierten Zugriffssteuerungsrollen, die Sie selbst erstellt haben):
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsMediaConfiguration"}
Parameter
Parameter | Erforderlich | Typ | Beschreibung |
---|---|---|---|
Identity |
Erforderlich |
XdsIdentity |
Die eindeutige ID der Medienkonfigurationseinstellungen, die entfernt werden sollen. Diese ID gibt den Gültigkeitsbereich dieser Konfiguration an (global, Standort oder Dienst). |
Force |
Optional |
Switch-Parameter |
Unterdrückt alle Bestätigungsaufforderungen, die andernfalls vor der Durchführung von Änderungen angezeigt würden. |
WhatIf |
Optional |
Switch-Parameter |
Beschreibt die Auswirkungen einer Ausführung des Befehls, ohne den Befehl tatsächlich auszuführen. |
Confirm |
Optional |
Switch-Parameter |
Fordert Sie vor der Ausführung des Befehls zum Bestätigen auf. |
Eingabetypen
Microsoft.Rtc.Management.WritableConfig.Settings.Media.MediaSettings-Objekt. Akzeptiert eine weitergeleitete Eingabe von Medienkonfigurationsobjekten.
Rückgabetypen
Entfernt ein Objekt vom Typ "Microsoft.Rtc.Management.WritableConfig.Settings.Media.MediaSettings".
Beispiel
-------------------------- Beispiel 1 --------------------------
Remove-CsMediaConfiguration -Identity site:Redmond1
In Beispiel 1 wird Remove-CsMediaConfiguration zum Löschen der Medienkonfigurationsauflistung mit der Identität "site:Redmond1" verwendet. Wenn Medieneinstellungen für den Gültigkeitsbereich "site" entfernt werden, verwendet der entsprechende Standort anschließend automatisch die globalen Medieneinstellungen.
-------------------------- Beispiel 2 --------------------------
Get-CsMediaConfiguration | Where-Object {$_.EncryptionLevel -eq "RequireEncryption"} | Remove-CsMediaConfiguration
Im vorangehenden Beispiel werden die drei Cmdlets Get-CsMediaConfiguration, Where-Object und Remove-CsMediaConfiguration verwendet, um sämtliche Medienkonfigurationsauflistungen zu entfernen, bei denen für alle Gesprächsteilnehmer eine Verschlüsselung erforderlich ist. Zu diesem Zweck wird zunächst Get-CsMediaConfiguration verwendet, um sämtliche Medienkonfigurationsauflistungen in der Organisation zurückzugeben. Diese Informationen werden anschließend an das Cmdlet Where-Object weitergeleitet, das wiederum einen Filter anwendet, um die übergebenen Daten auf Auflistungen zu beschränken, deren Eigenschaft "EncryptionLevel" den Wert "RequireEncryption" aufweist (der Vergleichsoperator "-eq" steht für "equal to"). Diese Daten werden schließlich an Remove-CsMediaConfiguration übergeben, um alle Elemente in dieser gefilterten Auflistung zu löschen.
-------------------------- Beispiel 3 --------------------------
Get-CsMediaConfiguration -Filter service:* | Remove-CsMediaConfiguration
In diesem Beispiel werden alle Medienkonfigurationen entfernt, die mit dem Gültigkeitsbereich "service" definiert sind (also Konfigurationen, die sich auf einen bestimmten Dienst beziehen). Zu diesem Zweck wird zunächst Get-CsMediaConfiguration mit dem Filterparameter "service:*" aufgerufen. Über diesen Filter werden alle Medienkonfigurationsauflistungen abgerufen, deren Identität mit der Zeichenfolge "service:" beginnt, also alle Auflistungen, die für einen Dienst gelten. Diese Auflistungen werden dann zum Entfernen an Remove-CsMediaConfiguration weitergeleitet.
Siehe auch
Weitere Ressourcen
New-CsMediaConfiguration
Set-CsMediaConfiguration
Get-CsMediaConfiguration