• Artikel

Get-CsMediaConfiguration

 

Letztes Änderungsdatum des Themas: 2012-03-23

Gibt Informationen zu Medieneinstellungen zurück, u. a. die unterstützte Verschlüsselung; Informationen dazu, ob Siren vom Vermittlungsserver bei der Interaktion mit Microsoft Lync 2010-Clients als Sprachcodec verwendet werden kann, sowie die maximal zulässige Videoauflösung.

Syntax

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

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

Detaillierte Beschreibung

Mit diesem Cmdlet werden eine oder mehrere Auflistungen mit Einstellungen abgerufen, die Medieninteraktionen definieren.

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

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Optional

XdsIdentity

Die eindeutige ID der Medienkonfiguration, die abgerufen werden soll. Diese ID gibt den Gültigkeitsbereich dieser Konfiguration an (global, Standort oder Dienst).

Filter

Optional

Zeichenfolge

Dieser Parameter filtert die Ergebnisse der Get-Operation basierend auf dem an diesen Parameter übergebenen Platzhalterwert.

LocalStore

Optional

Switch-Parameter

Ruft die Informationen zur Medienkonfiguration aus dem lokalen Replikat des zentraler Verwaltungsspeichers ab, statt die Daten aus dem zentraler Verwaltungsspeicher selbst abzurufen.

Eingabetypen

Keine.

Rückgabetypen

Mit Get-CsMediaConfiguration werden Instanzen des Objekts" Microsoft.Rtc.Management.WritableConfig.Settings.Media.MediaSettings" zurückgegeben.

Beispiel

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

Get-CsMediaConfiguration

In Beispiel 1 werden alle Medienkonfigurationen zurückgegeben, die in Ihrer Organisation verwendet werden. Zu diesem Zweck wird das Cmdlet Get-CsMediaConfiguration ohne zusätzliche Parameter aufgerufen.

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

Get-CsMediaConfiguration -Identity site:Redmond1

Im vorstehenden Beispiel wird lediglich die Medienkonfiguration mit dem Identitätswert "site:Redmond1" zurückgegeben. Da Identitätswerte eindeutig sein müssen, wird durch die Angabe eines Identitätswerts sichergestellt, dass jeweils nur ein Element abgerufen wird.

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

Get-CsMediaConfiguration -Filter site:*

In Beispiel 3 werden mithilfe des Parameters "Filter" alle Medienkonfigurationen auf Standortebene zurückgegeben. Über die Platzhalterzeichenfolge "site:*" wird sichergestellt, dass Windows PowerShell nur Medienkonfigurationen zurückgibt, deren Identitätswerte mit dem Zeichenfolgenwert "site:" beginnen.

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

Get-CsMediaConfiguration | Where-Object {$_.EncryptionLevel -eq "SupportEncryption"}

In diesem Beispiel werden Get-CsMediaConfiguration und Where-Object verwendet, um alle Medienkonfigurationen zurückzugeben, die eine Verschlüsselung unterstützen (jedoch nicht erfordern). Zu diesem Zweck verwendet der Befehl zunächst Get-CsMediaConfiguration zum Abrufen aller Medienkonfigurationen, die in Ihrer Organisation verwendet werden. Diese Informationen werden anschließend an das Cmdlet Where-Object weitergeleitet, das wiederum einen Filter anwendet, um die zurückgegebenen Daten auf die Konfigurationen zu beschränken, deren Eigenschaft "EncryptionLevel" den Wert "SupportEncryption" aufweist (der Vergleichsoperator "-eq" steht für "equal to").

-------------------------- Beispiel 5 --------------------------

Get-CsMediaConfiguration -Filter *:*med*

In diesem Beispiel werden alle für Standorte und Dienste definierte Medienkonfigurationen abgerufen, deren Namen die Zeichenfolge "med" enthalten. Dieser Befehl ruft z. B. die für den Standort "medford1", den Standort "TwoMedfordPlace" und den Dienst "MediationServer:redmond.litwareinc.com" definierten Medienkonfigurationseinstellungen ab.