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.
Siehe auch
Weitere Ressourcen
Remove-CsMediaConfiguration
Set-CsMediaConfiguration
Get-CsMediaConfiguration