• Artikel

Get-CsNetworkBandwidthPolicyProfile

 

Letztes Änderungsdatum des Themas: 2012-03-23

Ruft eine oder mehrere Richtlinienprofile für die Netzwerkbandbreite auf.

Syntax

Get-CsNetworkBandwidthPolicyProfile [-Identity <XdsGlobalRelativeIdentity>] [-LocalStore <SwitchParameter>]

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

Detaillierte Beschreibung

Im Rahmen der Anrufsteuerung wird eine Bandbreitenrichtlinie dazu verwendet, Bandbreiteneinschränkungen für bestimmte Modalitäten zu definieren. (In Microsoft Lync Server 2010 können Bandbreiteneinschränkungen nur für Audio und Video zugewiesen werden.) Dieses Cmdlet ruft ein oder mehrere Containerprofile für diese Richtlinien ab.

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

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Optional

XdsGlobalRelativeIdentity

Ein Zeichenfolgenwert zur eindeutigen Kennzeichnung des abzurufenden Bandbreitenrichtlinienprofils. Durch Angabe eines Identitätswerts wird maximal ein Profil abgerufen.

Filter

Optional

Zeichenfolge

Eine Zeichenfolge mit Platzhalterzeichen, mit der Bandbreitenrichtlinienprofile abgerufen werden, deren Identitätswert mit dem Platzhaltermuster übereinstimmt.

LocalStore

Optional

Switch-Parameter

Ruft das Richtlinienprofil für die Netzwerkbandbreite aus dem lokalen Replikat des zentraler Verwaltungsspeichers ab, statt die Daten aus dem zentraler Verwaltungsspeicher selbst abzurufen.

Eingabetypen

Keine.

Rückgabetypen

Gibt ein Objekt vom Typ "Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.BWPolicyProfileType" zurück.

Beispiel

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

Get-CsNetworkBandwidthPolicyProfile

Wenn Get-CsNetworkBandwidthPolicyProfile ohne Parameter aufgerufen wird, werden alle Bandbreitenrichtlinienprofile abgerufen, die innerhalb der Lync Server 2010-Bereitstellung definiert sind.

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

Get-CsNetworkBandwidthPolicyProfile -Identity LowBWProfile

In diesem Beispiel wird das Bandbreitenrichtlinienprofil mit dem Identitätswert "LowBWProfile" abgerufen. Da Identitätswerte eindeutig sein müssen, wird maximal ein Profil zurückgegeben.

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

Get-CsNetworkBandwidthPolicyProfile -Filter *50MB*

In diesem Beispiel werden mit dem Parameter "Filter" ein oder mehrere Profile angegeben, die mithilfe einer Platzhaltersuchzeichenfolge abgerufen werden sollen. Es wird die Zeichenfolge "*50MB*" verwendet, die alle Bandbreitenrichtlinienprofile mit einem Identitätswert mit der Zeichenfolge 50MB abruft. Dies ruft beispielsweise Profile mit dem Identitätswert "BW profile for 50MB links", "50MB audio limit" und "video limits of 50MB" ab.