Freigeben über

  • Artikel

Set-CsAVEdgeConfiguration

 

Letztes Änderungsdatum des Themas: 2012-03-26

Ermöglicht es Ihnen, die Konfigurationseinstellungen für Computer zu ändern, auf denen der A/V-Edgedienst ausgeführt wird. (Diese Computer werden auch als A/V-Edgeserver bezeichnet.) Mit einem A/V-Edgeserver können interne Benutzer Audio- und Videodaten für externe Benutzer (d. h. Benutzer, die nicht bei Ihrem internen Netzwerk angemeldet sind) freigeben sowie Dateien austauschen und an Desktopfreigabesitzungen teilnehmen.

Syntax

Set-CsAVEdgeConfiguration [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-MaxBandwidthPerPortKb <UInt32>] [-MaxBandwidthPerUserKb <UInt32>] [-MaxTokenLifetime <TimeSpan>] [-WhatIf [<SwitchParameter>]]

Set-CsAVEdgeConfiguration [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-MaxBandwidthPerPortKb <UInt32>] [-MaxBandwidthPerUserKb <UInt32>] [-MaxTokenLifetime <TimeSpan>] [-WhatIf [<SwitchParameter>]]

Detaillierte Beschreibung

A/V-Edgeserver bieten die Möglichkeit, Audio- und Videodaten ü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 den Edgeserver können global, auf Standortebene und auf Dienstebene zugewiesen werden. Mit diesen Konfigurationseinstellungen können Administratoren u. a. verwalten, wie lange die Benutzerauthentifizierung gültig ist, bevor sie erneuert werden muss, oder die Bandbreite einschränken, die von einem Benutzer oder Port verwendet werden kann.

Sie können mit dem Cmdlet Set-CsAVEdgeConfiguration die Konfigurationseinstellungen für A/V-Edgeserver ändern, die derzeit in Ihrer Organisation verwendet werden. Es wird jedoch empfohlen, dass Administratoren die standardmäßigen A/V-Edgeeinstellungen nicht ändern, es sei denn, es liegt eine Anweisung des Microsoft-Supports vor.

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

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Optional

XdsIdentity

Die eindeutige ID für die zu ändernde Auflistung von Konfigurationseinstellungen für A/V-Edgeserver. Verwenden Sie folgende Syntax, um die globale Auflistung zu ändern: -Identity global. Verwenden Sie eine Syntax wie die folgende, um eine Standortauflistung zu ändern: -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.

Instance

Optional

MediaRelaySettings-Objekt

Ermöglicht Ihnen, einen Verweis auf ein Objekt an das Cmdlet zu übergeben, statt individuelle Parameterwerte festzulegen.

MaxBandwidthPerPortKB

Optional

Ganze Zahl

Gibt die maximale Bandbreite (in Kilobit pro Sekunde) an, die einem einzelnen Port zugewiesen werden kann. Die maximale Bandbreite kann auf einen beliebigen ganzzahligen Wert von 1 bis 4294967296 (4096 Gigabit) festgelegt werden. Der Standardwert lautet 3000.

MaxBandwidthPerUserKB

Optional

Ganze Zahl

Gibt die maximale Bandbreite (in Kilobit pro Sekunde) an, die einem beliebigen Benutzer zugewiesen werden kann. Die maximale Bandbreite kann auf einen beliebigen ganzzahligen Wert von 1 bis 4294967296 (4096 Gigabit) festgelegt werden. Der Standardwert lautet 10000.

MaxTokenLifetime

Optional

TimeSpan

Die maximale Zeitspanne, die ein Authentifizierungstoken verwenden kann, bevor es abläuft und erneuert werden muss. Die Gültigkeitsdauer von Token wird im folgenden Format angegeben: Tage.Stunden:Minuten:Sekunden. Beispiel: 13 Tage werden wie folgt ausgedrückt (mit einem Punkt (.) nach der Anzahl der Tage und mit Doppelpunkten (:), um die Stunden, Minuten und Sekunden voneinander zu trennen):

13.00:00:00

Der Standardwert von 8 Stunden wird wie folgt ausgedrückt:

08:00:00

Die kürzeste zulässige Gültigkeitsdauer von Token beträgt 1 Minute (00:01:00). Die maximal zulässige Gültigkeitsdauer beträgt 180 Tage (180.00:00:00).

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. Set-CsAVEdgeConfiguration akzeptiert eine weitergeleitete Eingabe von Objekten für Mediarelayeinstellungen.

Rückgabetypen

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

Beispiel

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

Set-CsAVEdgeConfiguration -Identity global -MaxTokenLifetime "04:00:00"

Der Befehl in Beispiel 1 ändert die Eigenschaft "MaxTokenLifetime" für die globalen Konfigurationseinstellungen für A/V-Edgeserver. In diesem Beispiel wird die maximale Gültigkeitsdauer des Tokens auf 4 Stunden festgelegt (4 Stunden : 00 Minuten : 00 Sekunden).