New-CsNetworkMediaBypassConfiguration

Syntax

New-CsNetworkMediaBypassConfiguration [-AlwaysBypass <$true | $false>] [-BypassID <String>] [-Enabled <$true | $false>] [-EnableDefaultBypassID <$true | $false>] [-ExternalBypassMode <Nullable>] [-InternalBypassMode <Nullable>]

Detaillierte Beschreibung

Mit diesem Cmdlet werden globale Einstellungen für die Medienumgehung von Audioverbindungen erstellt.

Anders als die meisten New-Cmdlets in Microsoft Lync Server 2010 wird bei diesem Cmdlet die neue Konfiguration nicht unmittelbar gespeichert; vielmehr werden die Einstellungen nur im Arbeitsspeicher erstellt. Das mit diesem Cmdlet erstellte Objekt muss in einer Variablen gespeichert und dann der Eigenschaft "MediaBypassSettings" der Netzwerkkonfiguration zugewiesen werden. (Ausführliche Informationen finden Sie in den Beispielen weiter unten in diesem Thema.)

Die mit diesem Cmdlet erstellten Einstellungen können nur durch Zugriff auf die Eigenschaft "MediaBypassSettings" der globalen Netzwerkkonfiguration abgerufen werden. Führen Sie diesen Befehl aus, um diese Einstellungen abzurufen: (Get-CsNetworkConfiguration).MediaBypassSettings.

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

Parameter

Eingabetypen

Keine.

Rückgabetypen

Erstellt einen Objektverweis vom Typ "Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.MediaBypassSettingsType".

Beispiel

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

$a = New-CsNetworkMediaBypassConfiguration -AlwaysBypass $true -Enabled $true
Set-CsNetworkConfiguration -MediaBypassSettings $a

Die Befehle in diesem Beispiel aktivieren die Medienumgehung und konfigurieren sie derart, dass immer eine Umgehung versucht wird. Die erste Zeile in diesem Beispiel besteht aus einem Aufruf des Cmdlets New-CsNetworkMediaBypassConfiguration. An dieses Cmdlet werden zwei Parameter übergeben: "AlwaysBypass" und "Enabled", wobei beide auf "True" ($true) festgelegt werden. Wenn Sie "Enabled" auf "True" festlegen, wird die Medienumgehung aktiviert. Durch das Festlegen von "AlwaysBypass" auf "True" wird sichergestellt, dass die Medienumgehung für alle Anrufe versucht wird. (Beachten Sie, dass durch das Festlegen dieser beiden Parameter automatisch ein Wert für die Eigenschaft "BypassID" generiert wird.) Mit New-CsNetworkMediaBypassConfiguration wird das Objekt nur im Arbeitsspeicher erstellt, woraufhin das Objekt der Variablen "$a" zugewiesen wird.

Die Medienumgehungskonfiguration wird in den Netzwerkkonfigurationseinstellungen gespeichert. Daher werden in Zeile 2 des Beispiels Änderungen an der Medienumgehungskonfiguration in der Netzwerkkonfiguration gespeichert, indem das Cmdlet Set-CsNetworkConfiguration aufgerufen wird. Hierbei wird das Konfigurationsobjekt für die Medienumgehung ($a), das in Zeile 1 erstellt wurde, an den Parameter "MediaBypassSettings" übergeben.

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

$a = (Get-CsNetworkConfiguration).MediaBypassSettings
$a.AlwaysBypass = $false
Set-CsNetworkConfiguration -MediaBypassSettings $a

In Lync Server gibt es kein Cmdlet Set-CsNetworkMediaBypassConfiguration. Wenn Sie daher die vorhandenen Einstellungen ändern möchten, müssen Sie entweder eine neue Konfiguration erstellen (siehe Beispiel 1), die die vorhandene Konfiguration ersetzt, oder Sie müssen die Einstellungen ändern, indem Sie die vorhandenen Einstellungen abrufen, diese ändern und die Änderungen anschließend mit dem Cmdlet Set-CsNetworkConfiguration speichern. Dieses Beispiel zeigt, wie Sie die Option zum stetigen Umgehen mithilfe der letzten Option deaktivieren können.

Der Befehl in der ersten Zeile im Beispiel ruft die vorhandenen Medienumgehungseinstellungen ab. Hierzu wird das Cmdlet Get-CsNetworkConfiguration aufgerufen. Der Aufruf dieses Cmdlets wird in Klammern angegeben, um sicherzustellen, dass das Cmdlet vollständig ausgeführt wurde, bevor ein anderer Teil des Befehls ausgeführt wird. Mit Get-CsNetworkConfiguration werden alle Einstellungen für eine gesamte Netzwerkkonfiguration abgerufen. Da nur die Medienumgehungseinstellungen betrachtet werden sollen, wird die Eigenschaft "MediaBypassSettings" angegeben, um nur diese Einstellungen abzurufen. Diese Einstellungen werden der Variablen "$a" zugewiesen.

In Zeile 2 werden die in der Variablen "$a" gespeicherten Einstellungen geändert, in dem der Eigenschaft "AlwaysBypass" der Wert "False" ($false) zugewiesen wird. In Zeile 3 wird Set-CsNetworkConfiguration aufgerufen, wobei die Variable "$a" an den Parameter "MediaBypassSettings" übergeben wird, wodurch die an der Eigenschaft "AllowBypass" vorgenommenen Änderungen gespeichert werden.

Siehe auch

Weitere Ressourcen

Get-CsNetworkConfiguration
Set-CsNetworkConfiguration