Freigeben über

  • Artikel

New-CsMediaConfiguration

 

Letztes Änderungsdatum des Themas: 2012-03-26

Erstellt eine neue Auflistung von Medieneinstellungen. Über diese Einstellungen können Aspekte wie der unterstützte Verschlüsselungsgrad und die maximal zulässige Videoauflösung festgelegt werden.

Syntax

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

Detaillierte Beschreibung

Dieses Cmdlet erstellt eine neue Auflistung von Einstellungen, über die das Verhalten für bestimmte Medienaktionen definiert wird.

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

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Erforderlich

XdsIdentity

Eine eindeutige ID zur Angabe des Gültigkeitsbereichs dieser Konfiguration (Standort oder Dienst). Eine Konfiguration auf Standortebene wird im Format "site:<Standortname>" eingegeben, wie z. B. "site:Redmond". Ein Dienst wird in der Form "<Serverrolle>:<FQDN>" eingegeben, z. B. "MediationServer:pool0.litwareinc.com". Es liegt immer eine globale Medienkonfiguration vor, die nicht entfernt werden kann, daher kann keine neue globale Konfiguration erstellt werden.

Medienkonfigurationen auf Dienstebene können nur für den A/V-Konferenzserver, den Vermittlungsserver und den Anwendungsserver erstellt werden.

EnableQoS

Optional

Boolescher Wert

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

Standard: False

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.

Standard: False

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.

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.

Standard: VGA600K

Force

Optional

Switch-Parameter

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

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.

Rückgabetypen

Erstellt ein Objekt vom Typ "Microsoft.Rtc.Management.WritableConfig.Settings.Media.MediaSettings".

Beispiel

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

New-CsMediaConfiguration -Identity site:Redmond1 -EncryptionLevel RequireEncryption

In Beispiel 1 wird mit New-CsMediaConfiguration eine neue Medienkonfiguration mit dem Identitätswert "site:Redmond1" erstellt. Diese neue Konfiguration erfordert, dass beide Seiten einer Multimediaverbindung die Verschlüsselung verwenden. Diese Anforderung wird erfüllt, indem der Parameter "EncryptionLevel" mit dem Wert "RequireEncryption" hinzugefügt wird.

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

New-CsMediaConfiguration -Identity MediationServer:pool0.litwareinc.com -EnableSiren $True

In diesem Beispiel wird mit New-CsMediaConfiguration eine neue Medienkonfiguration mit dem Identitätswert "MediationServer:pool0.litwareinc.com" erstellt. Diese neue Konfiguration erhält für den Parameter "EnableSiren" den Wert "True", was bedeutet, dass Siren für Anrufe mit diesem Vermittlungsserver aktiviert wird.