Freigeben über

  • Artikel

Get-CsAVEdgeConfiguration

 

Letztes Änderungsdatum des Themas: 2012-03-23

Gibt Konfigurationsinformationen für Computer zurück, die in Ihrer Organisation den A/V-Edgedienst ausführen. Mit den Konfigurationseinstellungen auf diesen Computern, auch A/V-Edgeserver genannt, 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

Get-CsAVEdgeConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]

Get-CsAVEdgeConfiguration [-Filter <String>] [-LocalStore <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 beispielsweise 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 Get-CsAVEdgeConfiguration können Sie Informationen zu den Konfigurationseinstellungen für A/V-Edgeserver abrufen, die derzeit in Ihrer Organisation verwendet werden.

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

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Optional

XdsIdentity

Die eindeutige ID für die Auflistung abzurufender Konfigurationseinstellungen für A/V-Edgeserver. Verwenden Sie folgende Syntax, um die globale Auflistung abzurufen: -Identity global. Verwenden Sie eine Syntax wie die folgende, um die Standortauflistung abzurufen: -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. Beachten Sie, dass Sie beim Festlegen eines Richtlinienidentitätswerts keine Platzhalter verwenden können.

Wenn dieser Parameter nicht angegeben ist, gibt Get-CsAVEdgeConfiguration eine Auflistung aller in der Organisation verwendeten Konfigurationseinstellungen für Edgeserver zurück.

Filter

Optional

Zeichenfolge

Ermöglicht die Verwendung von Platzhalterzeichen beim Angeben der zurückzugebenden Konfigurationseinstellungen für A/V-Edgeserver. Verwenden Sie beispielsweise folgende Syntax, um alle auf Standortebene konfigurierten Einstellungen zurückzugeben. -Filter site:*. Verwenden Sie folgende Syntax, um eine Auflistung aller auf Dienstebene konfigurierten Einstellungen zurückzugeben. -Filter "service:*".

LocalStore

Optional

Switch-Parameter

Ruft die Konfigurationsdaten für A/V-Edgeserver aus dem lokalen Replikat des zentraler Verwaltungsspeichers ab, statt die Daten aus dem zentraler Verwaltungsspeicher selbst abzurufen.

Eingabetypen

Keine. Get-CsAVEdgeConfiguration akzeptiert keine weitergeleitete Eingabe.

Rückgabetypen

Mit Get-CsAVEdgeConfiguration werden Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Settings.Edge.MediaRelaySettings" zurückgegeben.

Beispiel

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

Get-CsAVEdgeConfiguration

Der Befehl in Beispiel 1 gibt alle derzeit in der Organisation konfigurierten Konfigurationseinstellungen für A/V-Edgeserver zurück. Beim Aufrufen von Get-CsAVEdgeConfiguration ohne zusätzliche Parameter wird immer eine vollständige Auflistung der Konfigurationseinstellungen für A/V-Edgeserver zurückgegeben.

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

Get-CsAVEdgeConfiguration -Identity site:Redmond

In Beispiel 2 wird eine einzige Auflistung von Konfigurationseinstellungen für A/V-Edgeserver zurückgegeben: die Auflistung mit dem Identitätswert "site:Redmond".

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

Get-CsAVEdgeConfiguration -Filter "site:*"

Der vorstehende Befehl gibt eine Auflistung aller Konfigurationseinstellungen für A/V-Edgeserver zurück, die auf Standortebene konfiguriert wurden. Hierzu wird das Cmdlet Get-CsAVEdgeConfiguration mit dem Parameter "Filter" aufgerufen. Der Filterwert "site:*" beschränkt die zurückgegebenen Daten auf die Einstellungen, deren Identitätswert mit dem Zeichenfolgenwert "site:" beginnt. Laut Definition beschränkt dies die zurückgegebenen Daten auf Einstellungen, die auf Standortebene konfiguriert wurden.

-------------------------- Beispiel 4 --------------------------

Get-CsAVEdgeConfiguration | Where-Object {$_.MaxBandwidthPerUserKB -gt 10000}

In Beispiel 4 werden nur die Konfigurationseinstellungen für A/V-Edgeserver zurückgegeben, deren Eigenschaft "MaxBandwidthPerUserKB" größer ist als 10.000 KBit/s. Hierzu wird im Befehl zunächst Get-CsAVEdgeConfiguration ohne Parameter ausgeführt; eine Auflistung aller derzeit verwendeten Konfigurationseinstellungen für A/V-Edgeserver wird zurückzugeben. Diese Auflistung wird dann an das Cmdlet Where-Object weitergeleitet, das die Einstellungen herausfiltert, bei denen die Eigenschaft "MaxBandwidthPerUserKB" größer als 10.000 KBit/s ist.

-------------------------- Beispiel 5 --------------------------

Get-CsAVEdgeConfiguration | Where-Object {$_.MaxBandwidthPerUserKB -eq 10000}

Beispiel 5 ähnelt dem Befehl in Beispiel 4; hier werden jedoch nur A/V-Edgeeinstellungen zurückgegeben, bei denen die Eigenschaft "MaxBandwidthPerUserKB" genau 10.000 KBit/s entspricht.

-------------------------- Beispiel 6 -------------------------

Get-CsAVEdgeConfiguration | Where-Object {$_.MaxTokenLifetime -lt "08:00:00"}

Der Befehl in Beispiel 6 gibt nur die Konfigurationseinstellungen für A/V-Edgeserver zurück, deren Eigenschaft "MaxTokenLifetime" weniger als 8 Stunden beträgt (08 Stunden : 00 Minuten : 00 Sekunden). Der Befehl ruft zunächst Get-CsAVEdgeConfiguration ohne Parameter auf, um eine Auflistung aller Konfigurationseinstellungen für A/V-Edgeserver in der Organisation zurückzugeben. Diese Auflistung wird dann an das Cmdlet Where-Object weitergeleitet, das die Einstellungen herausfiltert, bei denen die Eigenschaft "MaxTokenLifetime" kleiner als 8 Stunden ist (08:00:00).