Freigeben über


Remove-CsAVEdgeConfiguration

 

Letztes Änderungsdatum des Themas: 2012-03-27

Ermöglicht Ihnen das Entfernen einer vorhandenen Auflistung von Konfigurationseinstellungen, die auf Computer mit dem Zugriffs-Edgedienst angewendet werden. (Diese Computer werden auch als A/V-Edgeserver bezeichnet). Mit A/V-Edgeservern können interne Benutzer Audio- und Videodaten für externe Benutzer (d. h. Benutzer, die nicht bei Ihrem internen Netzwerk angemeldet sind) freigeben.

Syntax

Remove-CsAVEdgeConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Detaillierte Beschreibung

A/V-Edgeserver bieten die Möglichkeit, Audio- und Videodatenverkehr über die Organisationsfirewall auszutauschen. So können Benutzer unter anderem Microsoft Lync Server 2010 über das Internet verwenden und Audio- und Videodaten mit Benutzern austauschen, die sich innerhalb der Firewall beim System angemeldet haben. Die Konfigurationseinstellungen für Edgeserver können global, auf Standortebene und auf Dienstebene zugewiesen werden. Mit den Konfigurationseinstellungen für A/V-Edgeserver können Administratoren zum Beispiel verwalten, wie lange die Benutzerauthentifizierung gültig ist, bevor sie erneuert werden muss, sowie die Bandbreite einschränken, die von einem Benutzer oder Port verwendet werden kann.

Mit dem Cmdlet Remove-CsAVEdgeConfiguration können Sie Konfigurationseinstellungen für A/V-Edgeserver löschen, die entweder auf Standort- oder auf Dienstebene angewendet wurden. Das Cmdlet kann auch für die globalen Einstellungen ausgeführt werden, die globalen Einstellungen werden jedoch nicht gelöscht. Stattdessen werden alle Eigenschaften in der globalen Auflistung auf die Standardwerte zurückgesetzt.

Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet Remove-CsAVEdgeConfiguration lokal ausfü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-CsAVEdgeConfiguration"}

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Erforderlich

XdsIdentity

Eindeutige ID für die zu entfernende Auflistung von Konfigurationseinstellungen für A/V-Edgeserver. Verwenden Sie folgende Syntax, um die globale Auflistung zu "entfernen": -Identity global. (Wie bereits angemerkt wurde, können die globalen Einstellungen nicht entfernt werden. Die Eigenschaften können lediglich auf ihre Standardwerte zurückgesetzt werden.) Verwenden Sie eine Syntax wie die folgende, um eine Standortauflistung zu entfernen: -Identity site:Redmond. Einstellungen, die auf Dienstebene konfiguriert wurden, müssen auf eine Syntax wie die folgende verweisen:

-Identity service:EdgeServer:atl-cs-001.litwareinc.com

Sie können beim Angeben einer Richtlinienidentität keine Platzhalter verwenden.

Force

Optional

Switch-Parameter

Unterdrückt die Anzeige von Meldungen bei nicht schwerwiegenden Fehlern, die beim Ausführen des Befehls auftreten können.

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.Edge.MediaRelaySettings-Objekt. Remove-CsAVEdgeConfiguration akzeptiert eine weitergeleitete Eingabe von Einstellungsobjekten für Mediarelays. Diese Objekte werden mit dem Cmdlet Get-CsAVEdgeConfiguration abgerufen.

Rückgabetypen

Remove-CsAVEdgeConfiguration gibt keine Werte oder Objekte zurück. Stattdessen werden mit dem Cmdlet Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Settings.Edge.MediaRelaySettings" gelöscht.

Beispiel

-------------------------- Beispiel 1 -------------------------

Remove-CsAVEdgeConfiguration -Identity site:Redmond

Mit dem vorstehenden Befehl werden die Konfigurationseinstellungen für A/V-Edgeserver mit dem Identitätswert "site:Redmond" entfernt. Nachdem die Einstellungen entfernt wurden, verwenden die A/V-Edgeserver am Standort "Redmond" automatisch die globalen Konfigurationseinstellungen.

-------------------------- Beispiel 2 -------------------------

Get-CsAVEdgeConfiguration -Filter "service:*" | Remove-CsAVEdgeConfiguration

In Beispiel 2 werden alle Konfigurationseinstellungen für A/V-Edgeserver gelöscht, die auf Dienstebene angewendet wurden. Hierzu ruft der Befehl Get-CsAVEdgeConfiguration mit dem Parameter "Filter" auf. Der Filterwert "service:*" stellt sicher, dass nur Einstellungen zurückgegeben werden, die auf Dienstebene konfiguriert wurden. Diese gefilterte Auflistung wird dann an Remove-CsAVEdgeConfiguration weitergeleitet, um sämtliche Elemente in der Auflistung zu löschen.

-------------------------- Beispiel 3 -------------------------

Get-CsAVEdgeConfiguration | Where-Object {$_.MaxBandwidthPerUserKB -lt 5000} | Remove-CsAVEdgeConfiguration

Der in Beispiel 3 gezeigte Befehl löscht alle Konfigurationseinstellungen für A/V-Edgeserver, bei denen der Wert von "MaxBandwidthPerUserKB" weniger als 5.000 KBit/s beträgt. Hierzu verwendet der Befehl zunächst Get-CsAVEdgeConfiguration ohne Parameter, um eine Auflistung aller A/V-Edgeeinstellungen zurückzugeben, die derzeit in der Organisation verwendet werden. Diese Auflistung wird an das Cmdlet Where-Object weitergeleitet, das nur die Einstellungen auswählt, bei denen die Eigenschaft "MaxBandwidthPerUserKB" einen niedrigeren Wert als 5000 aufweist. Die gefilterte Auflistung wird anschließend an das Cmdlet Remove-CsAVEdgeConfiguration weitergeleitet, das jedes Element in dieser Auflistung löscht.