Freigeben über

  • Artikel

Set-CsMediaConfiguration

 

Letztes Änderungsdatum des Themas: 2012-03-26

Ändert eine vorhandene Auflistung von Medieneinstellungen.

Syntax

Set-CsMediaConfiguration [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-EnableQoS <$true | $false>] [-EnableSiren <$true | $false>] [-EncryptionLevel <SupportEncryption | RequireEncryption | DoNotSupportEncryption>] [-Force <SwitchParameter>] [-MaxVideoRateAllowed <CIF250K | VGA600K | Hd720p15M>] [-WhatIf [<SwitchParameter>]]

Set-CsMediaConfiguration [-Confirm [<SwitchParameter>]] [-EnableQoS <$true | $false>] [-EnableSiren <$true | $false>] [-EncryptionLevel <SupportEncryption | RequireEncryption | DoNotSupportEncryption>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-MaxVideoRateAllowed <CIF250K | VGA600K | Hd720p15M>] [-WhatIf [<SwitchParameter>]]

Detaillierte Beschreibung

Mit diesem Cmdlet wird eine Auflistung von Einstellungen geändert, über die die Medienkonfiguration definiert wird. Diese Aktionen beziehen sich auf Audio- und Videoanrufe zwischen Clientendpunkten.

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

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Optional

XdsIdentity

Die eindeutige ID der Medienkonfigurationseinstellungen, die geändert werden sollen. Diese ID gibt den Gültigkeitsbereich dieser Konfiguration an (global, Standort oder Dienst).

Instance

Optional

MediaSettings

Eine Instanz des Objekts "Microsoft.Rtc.Management.WritableConfig.Settings.Media.MediaSettings". Zum Abrufen dieses Objekts können Sie Get-CsMediaConfiguration mit einer bestimmten Identität aufrufen. Anschließend können Sie den Eigenschaften des Objekts neue Werte zuweisen und diese Änderungen speichern, indem Sie das Objekt an Set-CsMediaConfiguration übergeben.

EnableQoS

Optional

Boolescher Wert

QoS überwacht die Qualität von VoIP-Signalen in einem Netzwerk.

EnableSiren

Optional

Boolescher Wert

Standardmäßig handelt der Vermittlungsserver nicht Siren als möglichen Codec für Anrufe mit anderen Microsoft Lync 2010-Clients aus. Wenn die Einstellung auf "True" festgelegt ist, wird Siren zur Liste der möglichen Codecs zwischen dem Vermittlungsserver und anderen Lync 2010-Clients hinzugefügt.

EncryptionLevel

Optional

EncryptionLevel

Der Verschlüsselungsgrad zwischen Unified Communications-Entitäten.

Gültige Werte:

SupportEncryption – Sofern aushandelbar, wird SRTP (Secure Real-Time Transport Protocol) verwendet.

RequireEncryption – SRTP muss ausgehandelt werden.

DoNotSupportEncryption – SRTP darf nicht verwendet werden.

Bei diesem Wert wird die Groß-/Kleinschreibung nicht berücksichtigt. (Ausführliche Informationen finden Sie in den Beispielen weiter unten in diesem Thema.)

Standard: RequireEncryption

MaxVideoRateAllowed

Optional

MaxVideoRateAllowed

Die Höchstrate, mit der Videosignale an die Clientendpunkte übermittelt werden.

Gültige Werte: Hd720p15M, VGA600K, CIF250K

Hd720p15M – High Definition, mit einer Auflösung von 1280 x 720 und dem Seitenverhältnis 16:9.

VGA600K – VGA, mit einer Auflösung von 640 x 480, 25 F/s mit dem Seitenverhältnis 4:3.

CIF250K – CIF-Videoformat (Common Intermediate Format), 15 F/s mit einer Auflösung von 352 x 288.

Beachten Sie, dass die Groß-/Kleinschreibung bei diesen Werten nicht beachtet wird. Beim Erstellen der Konfiguration werden die Werte in die richtige Groß-/Kleinschreibung konvertiert. (Ausführliche Informationen finden Sie in den Beispielen weiter unten in diesem Thema.)

Standard: VGA600K

Force

Optional

Switch-Parameter

Unterdrückt alle Bestätigungsaufforderungen, die andernfalls vor der Durchführung von Änderungen angezeigt würden.

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.Media.MediaSettings-Objekt. Akzeptiert eine weitergeleitete Eingabe von Medienkonfigurationsobjekten.

Rückgabetypen

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

Beispiel

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

Set-CsMediaConfiguration -Identity site:Redmond1 -MaxVideoRateAllowed hd720p15m

Im oben stehenden Beispiel wird die Medienkonfigurationsauflistung mit der Identität "site:Redmond1" geändert. Im Einzelnen wird der Wert der Eigenschaft "MaxVideoRateAllowed" auf "Hd720p15M" festgelegt. Beachten Sie, dass der an den Parameter "MaxVideoRateAllowed" übergebene Wert einem der in der Parameterbeschreibung angegebenen Wert entsprechen muss. Beachten Sie zudem, dass bei diesen Werten die Groß-/Kleinschreibung nicht beachtet wird. Wenn Sie z. B. den Wert "hd720p15m" aus diesem Beispiel eingeben, wird dieser Wert automatisch in die richtige Groß-/Kleinschreibung konvertiert (in diesem Fall in "Hd720p15M").

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

Set-CsMediaConfiguration site:Redmond1 -EncryptionLevel donotsupportencryption

In diesem Beispiel wird die Medienkonfigurationsauflistung mit der Identität "site:Redmond1" geändert, indem für "EncryptionLevel" der Wert "DoNotSupportEncryption" festgelegt wird. Beachten Sie, dass bei diesem Wert die Groß-/Kleinschreibung nicht berücksichtigt wird. Der Wert wurde als "donotsupportencryption" eingegeben, wird jedoch als gültiger Wert akzeptiert und automatisch in die Zeichenfolge mit Groß- und Kleinbuchstaben (DoNotSupportEncryption) konvertiert.