• Artikel

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.