Freigeben über

  • Artikel

New-CsAVEdgeConfiguration

 

Letztes Änderungsdatum des Themas: 2012-03-23

Erstellt eine neue Auflistung von Konfigurationseinstellungen für Computer, 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.

Syntax

New-CsAVEdgeConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-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 den Konfigurationseinstellungen für A/V-Edgeserver können Administratoren 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 New-CsAVEdgeConfiguration können Sie neue Auflistungen von Konfigurationseinstellungen für A/V-Edgeserver auf Standort- oder Dienstebene erstellen. Wie bereits erläutert, können A/V-Edgeeinstellungen auch global konfiguriert werden. Sie können jedoch keine neue Auflistung auf globaler Ebene erstellen.

Beachten Sie, dass jeder Standort oder Dienst maximal eine Auflistung von Konfigurationseinstellungen für A/V-Edgeserver hosten kann. Wenn am Standort "Redmond" bereits eine Auflistung von A/V-Edgeeinstellungen gehostet wird, können Sie mit dem Identitätswert "site:Redmond" keine neue Auflistung erstellen.

Es wird empfohlen, dass Sie die standardmäßigen Konfigurationseinstellungen für A/V-Edgeserver nicht ändern, es sei denn, Sie haben dazu eine Anweisung des Microsoft-Supports erhalten. Aus diesem Grund müssen Sie möglicherweise keine neue Auflistung von Einstellungen für einen Standort oder Dienst erstellen.

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

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Erforderlich

XdsIdentity

Die eindeutige ID für die zu erstellende Auflistung von Konfigurationseinstellungen für A/V-Edgeserver. Verwenden Sie eine Syntax wie die folgende, um eine Auflistung von auf Standortebene anzuwendenden Einstellungen zu erstellen: -Identity site:Redmond. (Beachten Sie, dass beim Ausführen dieses Befehls ein Fehler auftritt, wenn bereits eine Auflistung von Konfigurationseinstellungen für A/V-Edgeserver auf den Standort "Redmond" angewendet wurde.) Verwenden Sie für Einstellungen, die auf Dienstebene konfiguriert wurden, eine Syntax wie die folgende: -Identity service:EdgeServer:atl-cs-001.litwareinc.com.

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

Ganze Zahl

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.

InMemory

Optional

Switch-Parameter

Erstellt einen Objektverweis ohne einen Commit für das Objekt auszuführen und die Änderungen dadurch dauerhaft zu speichern. Wenn Sie die Ausgabe des mit diesem Parameter aufgerufenen Cmdlet einer Variablen zuweisen, können Sie die Eigenschaften des Objektverweises ändern und anschließend einen Commit für diese Änderungen ausführen, indem Sie das entsprechende Cmdlet vom Typ "Set-" aufrufen.

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

Keine. New-CsAVEdgeConfiguration akzeptiert keine weitergeleitete Eingabe.

Rückgabetypen

Erstellt Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Settings.Edge.MediaRelaySettings".

Beispiel

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

New-CsAVEdgeConfiguration -Identity site:Redmond -MaxTokenLifetime "04:00:00"

Der Befehl in Beispiel 1 erstellt eine neue Auflistung von Konfigurationseinstellungen für A/V-Edgeserver für den Standort "Redmond". In diesem Beispiel wurde der Wert der Eigenschaft "MaxTokenLifetime" auf 4 Stunden festgelegt (04 Stunden : 00 Minuten : 00 Sekunden).

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

$x = New-CsAVEdgeConfiguration -Identity site:Redmond -InMemory
$x.MaxTokenLifetime = "04:00:00"
Set-CsAVEdgeConfiguration -Instance $x

In Beispiel 2 wird dargestellt, wie Sie eine neue Auflistung von Konfigurationseinstellungen für A/V-Edgeserver im Arbeitsspeicher erstellen und dann später diese virtuellen Einstellungen in eine tatsächliche Auflistung von A/V-Edgeeinstellungen umwandeln können. Hierzu wird mit dem ersten Befehl im Beispiel eine neue Auflistung von Einstellungen für den Standort "Redmond" erstellt. Der Parameter "InMemory" wird hinzugefügt, um sicherzustellen, dass diese Einstellungen nur im Arbeitsspeicher erstellt und nicht sofort dem Standort "Redmond" zugewiesen werden. (Da diese Einstellungen nur im Arbeitsspeicher vorhanden sind, müssen sie in einer Variablen gespeichert werden, in diesem Fall in der Variablen "$x".)

Im zweiten Befehl wird der Wert der Eigenschaft "MaxTokenLifetime" auf 4 Stunden festgelegt (4 Stunden : 00 Minuten : 00 Sekunden). Im dritten Befehl werden mit dem Cmdlet Set-CsAVEdgeConfiguration die in der Variablen "$x" gespeicherten Einstellungen auf den Standort "Redmond" angewendet.