New-CsNetworkMediaBypassConfiguration
Letztes Änderungsdatum des Themas: 2012-03-26
Erstellt neue globale Einstellungen für die Medienumgehung.
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
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
AlwaysBypass |
Optional |
Boolescher Wert |
Wenn Sie diesen Parameter auf "True" festlegen, werden für alle Anrufe Medienumgehungen versucht. Legen Sie diesen Wert nur auf "True" fest, wenn die Anrufsteuerung deaktiviert wurde. Dieser Parameter sollte ausschließlich für Bereitstellungen auf "True" festgelegt werden, für die Folgendes gilt: - Es besteht keine Notwendigkeit zur Bandbreitensteuerung. - Es ist keine fein abgestimmte Konfiguration erforderlich, mit der die Anforderung einer Medienumgehung erkannt wird. - Zwischen Gateways und Clients ist vollständige Konnektivität gegeben. Wenn der Parameter "Enabled" auf "True" gesetzt wird und "AlwaysBypass" auf "False", nutzt die Umgehungslogik Konfigurationsstandorte und -regionen, um zu ermitteln, wann eine Umgehung möglich ist. Wenn Sie "AlwaysBypass" auf "True" festlegen, aber für den Parameter "Enable" nicht "True" festlegen, wird eine Warnung ausgegeben: Die Einstellung "AlwaysBypass" wird ignoriert, wenn "Enabled" auf "False" festgelegt wurde. Wenn Sie "AlwaysBypass" und "Enabled" auf "True" festlegen, wird automatisch eine ID für die Umgehung generiert, die in der Eigenschaft "BypassID" gespeichert wird. Standard: False |
BypassID |
Optional |
Zeichenfolge |
Die ID für die Medienumgehung. Wenn der Parameter "AlwaysBypass" auf "True" festgelegt wird und für diesen Parameter ein Wert angegeben wird, wird diese ID für die Medienumgehung allen Subnetzen zugeordnet. Wenn "AlwaysBypass" auf "False" festgelegt wird, wird der Wert von "BypassID" allen Subnetzen zugeordnet, die nicht in den Standorten und Regionen der Netzwerkkonfiguration gefunden werden. Diese ID muss im Format einer GUID vorliegen, z. B. 96f14dea-5170-429a-b92b-f1cb909c4bb6. Üblicherweise muss dieser Parameter jedoch weder festgelegt noch geändert werden. Dieser Wert wird automatisch generiert, wenn "Enabled" auf "True" festgelegt wurde und eine der folgenden Bedingungen gilt: 1) "AlwaysBypass" ist auf "True" festgelegt, oder 2) der Parameter "EnableDefaultBypassID" ist auf "True" festgelegt. |
Enabled |
Optional |
Boolescher Wert |
Legen Sie diesen Parameter auf "True" fest, um die Medienumgehung zu aktivieren. Umgehungsentscheidungen werden basierend auf dem Wert der Einstellung "AlwaysBypass" folgendermaßen getroffen: - Wenn "AlwaysBypass" auf "True" festgelegt ist, wird eine Umgehung für alle Anrufe versucht. - Ist "AlwaysBypass" auf "False" festgelegt, wird anhand der Standorte und Regionen in der Netzwerkkonfiguration ermittelt, ob eine Umgehung möglich ist. Standard: False |
EnableDefaultBypassID |
Optional |
Boolescher Wert |
Dieser Wert findet nur Anwendung, wenn "AlwaysBypass" auf "False" festgelegt ist. Wenn Sie diesen Wert auf "True" festlegen, wird automatisch eine Standard-ID für die Umgehung generiert. Dieser automatisch generierte Wert wird in der Eigenschaft "BypassID" gespeichert. Dieser Parameter ist nützlich, wenn ein gut verbundener Hauptdienst vorliegt, dessen Remotestandorte Verbindungen mit eingeschränkter Bandbreite aufweisen. Der Administrator muss lediglich anhand von Standorten und Regionen in der Netzwerkkonfiguration die den Remotestandorten zugeordneten Subnetze konfigurieren. Keines der dem Hauptdienst zugeordneten Subnetze muss definiert werden, und zwischen diesen Subnetzen wird automatisch eine Umgehung versucht. Standard: False |
ExternalBypassMode |
Optional |
BypassModeEnumType |
Für die zukünftige Verwendung reserviert. Eine externe Medienumgehung wird in Lync Server 2010 nicht unterstützt. Standard: Off |
InternalBypassMode |
Optional |
BypassModeEnumType |
Der Wert dieses Parameters steuert, wann Clients, die von innerhalb des Organisationsnetzwerks eine Verbindung herstellen, eine Medienumgehung versuchen können. Wenn "Enabled" auf "True" festgelegt ist, wird dieser Wert automatisch in "Any" geändert. Andere Werte für diesen Parameter sind für eine zukünftige Verwendung reserviert. Standard: Off |
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.