• Artikel

Get-CsBandwidthPolicyServiceConfiguration

 

Letztes Änderungsdatum des Themas: 2012-03-23

Ruft eine oder mehrere Konfigurationen des Bandbreitenrichtliniendiensts ab.

Syntax

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

Get-CsBandwidthPolicyServiceConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>]

Detaillierte Beschreibung

Mithilfe der Anrufsteuerung können Sie festlegen, ob basierend auf Bandbreiteneinschränkungen Echtzeitkommunikationssitzungen (z. B. Sprach- oder Videoanrufe) hergestellt werden können. In der Microsoft Lync Server 2010-Implementierung der Anrufsteuerung werden Regionen, Standorte und Subnetze in einem Netzwerk mit den Beziehungen und Verbindungen zwischen diesen Entitäten definiert, um Bandbreiteneinschränkungen zwischen ihnen zu definieren. Der Bandbreitenrichtliniendienst ist die Komponente, die in einer Lync Server 2010-Bereitstellung die Anrufsteuerung übernimmt und beispielsweise die Entscheidung ermöglicht, ob für einen zu tätigenden Anruf ausreichend Bandbreite zur Verfügung steht. Mit dem Cmdlet Get-CsBandwidthPolicyServiceConfiguration werden die Einstellungen für einen oder mehrere Bandbreitenrichtliniendienste abgerufen.

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

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Optional

XdsIdentity

Die eindeutige ID der Konfiguration, die abgerufen werden soll. Diese ID umfasst den Gültigkeitsbereich (für die globale Konfiguration) oder den Gültigkeitsbereich und den Namen (für die Konfiguration auf Standortebene, z. B. "site:Redmond").

Filter

Optional

Zeichenfolge

Eine Zeichenfolge mit einem oder mehreren Platzhalterzeichen zum Durchsuchen der Eigenschaft "Identity" aller Konfigurationen des Bandbreitenrichtliniendiensts, um alle Konfigurationen zu finden, bei denen "Identity" dem Platzhaltermuster entspricht. Beispiel: Der Filterwert "site:*" ruft alle Konfigurationen ab, bei denen die Identitätswerte mit der Zeichenfolge "site:" beginnen und mit einer beliebigen Zeichenfolge enden.

LocalStore

Optional

Switch-Parameter

Ruft die Konfiguration des Bandbreitenrichtliniendiensts aus dem lokalen Replikat des zentraler Verwaltungsspeichers ab, statt die Daten aus dem zentraler Verwaltungsspeicher selbst abzurufen.

Eingabetypen

Keine.

Rückgabetypen

Gibt ein oder mehrere Objekte vom Typ "Microsoft.Rtc.Management.WritableConfig.Settings.BandwidthPolicyServiceConfiguration.BandwidthPolicyServiceConfiguration" zurück.

Beispiel

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

Get-CsBandwidthPolicyServiceConfiguration

In Beispiel 1 werden alle Konfigurationen des Bandbreitenrichtliniendiensts abgerufen, die in der Microsoft Lync Server 2010-Implementierung definiert sind.

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

Get-CsBandwidthPolicyServiceConfiguration -Identity site:Redmond

In diesem Beispiel wird die Konfiguration des Bandbreitenrichtliniendiensts abgerufen, die für den Standort "Redmond" (-Identity site:Redmond) definiert ist.

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

Get-CsBandwidthPolicyServiceConfiguration -Filter site:*

In diesem Beispiel wird der Parameter "Filter" verwendet, um alle Konfigurationen des Bandbreitenrichtliniendiensts abzurufen, die auf Standortebene definiert sind. Hierzu wird dem Parameter "Filter" der Wert "site:*" übergeben. So wird die Eigenschaft "Identity" aller Konfigurationen des Bandbreitenrichtliniendiensts nach den Werten durchsucht, die mit "site:" beginnen mit beliebig anderen Zeichen enden. Da alle Konfiguration auf Standortebene die Identitätswerte haben, die mit "site:" beginnen und mit dem Namen des Standorts enden, werden mit diesem Filter alle Konfigurationen für alle Standorte gefunden.

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

Get-CsBandwidthPolicyServiceConfiguration | Where-Object {$_.MaxLogFileSizeMb -gt 4}

In Beispiel 4 werden alle Konfigurationen des Bandbreitenrichtliniendiensts abgerufen, bei denen Protokolldateien zulässig sind, die größer als vier Megabyte sind. Das Beispiel beginnt mit dem Aufruf des Cmdlets Get-CsBandwidthPolicyServiceConfiguration. Mit diesem Cmdlet wird eine Auflistung aller Konfigurationen abgerufen, die in der Lync Server-Bereitstellung definiert sind (siehe Beispiel 1). Diese Auflistung wird anschließend an das Cmdlet Where-Object weitergeleitet. Where-Object durchläuft die Elemente in der Auflistung nacheinander. Where-Object prüft für jedes Element in der Auflistung, ob der Wert der Eigenschaft "MaxLogFileSizeMb" größer ist als 4 (der Vergleichsoperator "-gt" steht für "greater than"). Wenn dies der Fall ist, bleibt dieses Element Teil der Auflistung und ist Teil der Befehlsausgabe. Wenn der Wert von "MaxLogFileSizeMb" nicht größer als 4 ist, wird das Element ignoriert und nicht zurückgegeben.