• Artikel

Set-CsNetworkConfiguration

 

Letztes Änderungsdatum des Themas: 2012-03-27

Ändert die Einstellungen für eine Netzwerkkonfiguration. Dieses Cmdlet wird meistens zum Aktivieren oder Deaktivieren der Anrufsteuerung verwendet.

Syntax

Set-CsNetworkConfiguration [-Identity <XdsIdentity>] [-BWPolicyProfiles <PSListModifier>] [-Confirm [<SwitchParameter>]] [-EnableBandwidthPolicyCheck <$true | $false>] [-Force <SwitchParameter>] [-InterNetworkRegionRoutes <PSListModifier>] [-InterNetworkSitePolicies <PSListModifier>] [-MediaBypassSettings <MediaBypassSettingsType>] [-NetworkRegionLinks <PSListModifier>] [-NetworkRegions <PSListModifier>] [-NetworkSites <PSListModifier>] [-Subnets <PSListModifier>] [-WhatIf [<SwitchParameter>]]

Set-CsNetworkConfiguration [-BWPolicyProfiles <PSListModifier>] [-Confirm [<SwitchParameter>]] [-EnableBandwidthPolicyCheck <$true | $false>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-InterNetworkRegionRoutes <PSListModifier>] [-InterNetworkSitePolicies <PSListModifier>] [-MediaBypassSettings <MediaBypassSettingsType>] [-NetworkRegionLinks <PSListModifier>] [-NetworkRegions <PSListModifier>] [-NetworkSites <PSListModifier>] [-Subnets <PSListModifier>] [-WhatIf [<SwitchParameter>]]

Detaillierte Beschreibung

Das Netzwerkkonfigurationsobjekt enthält alle Einstellungen für eine gesamte Anrufsteuerungskonfiguration innerhalb einer Microsoft Lync Server 2010-Bereitstellung sowie Medienumgehungseinstellungen. Sie können mit diesem Cmdlet einen beliebigen Teil der Anrufsteuerungskonfiguration ändern und müssen es verwenden, wenn die Medienumgehungseinstellungen geändert werden sollen. Zum Ändern der meisten Anrufsteuerungskonfigurationseinstellungen wird jedoch empfohlen, objekttypspezifische Cmdlets zu verwenden. Um beispielsweise mit Netzwerkregionen zu arbeiten, verwenden Sie die Cmdlets, die mit dem Substantiv "CsNetworkRegion" enden, statt den Parameter "NetworkRegions" dieses Cmdlets zu ändern.

Der Zweck dieses Cmdlets besteht in erster Linie darin, die Anrufsteuerung zu aktivieren (und zu deaktivieren) und Medienumgehungseinstellungen anzuwenden. Nachdem Sie die verschiedenen Komponenten eingerichtet haben, die für Ihre Konfiguration erforderlich sind (z. B. Regionen, Standorte und Subnetze), müssen Sie die Konfiguration aktivieren. Ansonsten funktioniert sie nicht. Setzen Sie dazu einfach den Parameter "EnableBandwidthPolicyCheck" auf "True". Beachten Sie jedoch, dass die Anrufsteuerung durch Ausführen dieses Cmdlets, bei dem "EnableBandwidthPolicyCheck" auf "True" festgelegt ist, nicht sofort aktiviert wird. Bevor sie aktiviert werden kann, wird eine Reihe von Überprüfungen ausgeführt, um sicherzustellen, dass das Setup richtig konfiguriert ist. Bei jedem Fehler bzw. jeder Diskrepanz im Setup wird eine Warnung angezeigt, mit der Sie gefragt werden, ob Sie die Aktivierung der Anrufsteuerung trotz des Problems fortsetzen möchten. Falls Sie sich zum Fortfahren entschließen (durch Drücken der Eingabetaste oder der Taste "Y"), wird die Überprüfung fortgesetzt. Tritt ein weiteres Problem auf, werden Sie erneut gefragt.

Wenn Sie die gesamte Überprüfung durchlaufen und den Vorgang bei jeder Warnung fortsetzen, wird "EnableBandwidthPolicyCheck" auf "True" festgelegt und die Anrufsteuerung aktiviert. Sie wird jedoch wahrscheinlich nicht erwartungsgemäß funktionieren, bevor die Probleme behoben wurden. Sollten Sie sich während der Überprüfung an einem beliebigen Punkt entschließen, den Vorgang anzuhalten (durch Eingabe von "N" bei einer Warnung), wird die Überprüfung beendet, und "EnableBandwidthPolicyCheck" bleibt auf "False" gesetzt (Standardeinstellung).

Wenn für "EnableBandwidthPolicyCheck" bereits "True" festgelegt wurde, können Sie Set-CsNetworkConfiguration aufrufen und den Wert "True" an den Parameter "EnableBandwidthPolicyCheck" übergeben, um die Überprüfung auszuführen, ohne Einstellungen zu ändern. Ist "EnableBandwidthPolicyCheck" auf "True" festgelegt, wird die Überprüfung außerdem jedes Mal ausgeführt, wenn Sie Set-CsNetworkConfiguration aufrufen, um Änderungen vorzunehmen.

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

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Optional

XdsIdentity

Dieser Wert ist immer "Global".

Instance

Optional

NetworkConfigurationSettings

Ein Verweis auf ein Netzwerkkonfigurationsobjekt. Dieses Objekt muss ein Objekt vom Typ "Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.NetworkConfigurationSettings" sein und kann über das Cmdlet Get-CsNetworkConfiguration abgerufen werden.

BWPolicyProfiles

Optional

PSListModifier

Eine Auflistung aller Bandbreitenrichtlinienprofile, die Standorten, standortübergreifenden Richtlinien und Netzwerkregionenverbindungen zugewiesen werden können. Jedes Bandbreitenrichtlinienprofil enthält Bandbreiteneinschränkungen (allgemeine Einschränkungen und Sitzungseinschränkungen) für Audio- und/oder Videoverbindungen. Eine vollständige Liste der Bandbreitenrichtlinienprofile können Sie mit dem Cmdlet Get-CsNetworkBandwidthPolicyProfile abrufen.

EnableBandwidthPolicyCheck

Optional

Boolescher Wert

Wenn Sie diesen Parameter auf "True" festlegen, wird die gesamte Anrufsteuerungskonfiguration überprüft. Wenn alle Überprüfungen erfolgreich sind oder Sie alle Warnungen ignorieren, wird die Anrufsteuerung aktiviert. Ist eine Überprüfung nicht erfolgreich, können Sie sie beenden. Der Wert von "EnableBandwidthPolicyCheck" wird dann nicht geändert.

Wenn Sie diesen Wert auf "False" festlegen, wird die Anrufsteuerung deaktiviert.

Standard: False

InterNetworkRegionRoutes

Optional

PSListModifier

Eine Auflistung aller Netzwerkregionenrouten, die innerhalb der Anrufsteuerungskonfiguration definiert sind. Sie können alle Mitglieder dieser Auflistung mit dem Cmdlet Get-CsNetworkInterRegionRoute abrufen.

InterNetworkSitePolicies

Optional

PSListModifier

Eine Auflistung von standortübergreifenden Netzwerkrichtlinien, die innerhalb der Anrufsteuerungskonfiguration definiert sind. Sie können alle Mitglieder dieser Auflistung mit dem Cmdlet Get-CsNetworkInterSitePolicy abrufen.

MediaBypassSettings

Optional

MediaBypassSettingsType

Ein Verweis auf ein Objekt, das die globalen Medienumgehungseinstellungen für die Anrufsteuerungskonfiguration definiert. Wenn Sie diesen Wert festlegen, werden alle vorhandenen Medienumgehungseinstellungen überschrieben. Sie erhalten diesen Objektverweis, indem Sie das Cmdlet New-CsNetworkMediaBypassConfiguration aufrufen und die neuen Konfigurationseinstellungen einer Variablen zuweisen. Übergeben Sie dieses Variable an den Parameter "MediaBypassSettings", um die globalen Medienumgehungseinstellungen zu ändern.

NetworkRegionLinks

Optional

PSListModifier

Eine Auflistung von Netzwerkregionenverbindungen, die innerhalb der Anrufsteuerungskonfiguration definiert sind. Mit jeder Netzwerkregionenverbindung wird eine Verbindung zwischen zwei Regionen und beliebigen zwischen diesen Regionen anzuwendenden Bandbreiteneinschränkungen definiert. Sie können alle Mitglieder dieser Auflistung mit dem Cmdlet Get-CsNetworkRegionLink abrufen.

NetworkRegions

Optional

PSListModifier

Eine Auflistung von Netzwerkregionen (von denen jede einen Hub oder Backbone innerhalb des Netzwerks darstellt), die innerhalb der Anrufsteuerungskonfiguration definiert sind. Sie können alle Mitglieder dieser Auflistung mit dem Cmdlet Get-CsNetworkRegion abrufen.

NetworkSites

Optional

PSListModifier

Eine Auflistung von Netzwerkstandorten (von denen jeder ein Büro oder einen Standort innerhalb des Netzwerks darstellt), die innerhalb der Anrufsteuerungskonfiguration definiert sind. Sie können alle Mitglieder dieser Auflistung mit dem Cmdlet Get-CsNetworkSite abrufen.

Subnets

Optional

PSListModifier

Eine Auflistung von Netzwerksubnetzen (von denen jedes einen Endpunkt einem Standort zuordnet), die innerhalb der Anrufsteuerungskonfiguration definiert sind. Sie können alle Mitglieder dieser Auflistung mit dem Cmdlet Get-CsNetworkSubnet abrufen.

Force

Optional

Switch-Parameter

Dieser Parameter hat keinen Wert. Wenn Sie diesen Parameter angeben, werden alle Änderungen an der Konfiguration, einschließlich ihrer Aktivierung, ohne Warnungen oder Überprüfungen vorgenommen.

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

Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.NetworkConfigurationSettings-Objekt. Akzeptiert eine weitergeleitete Eingabe von Netzwerkkonfigurationsobjekten.

Rückgabetypen

Set-CsNetworkConfiguration gibt keine Werte oder Objekte zurück. Stattdessen werden mit dem Cmdlet Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.NetworkConfigurationSettings" geändert.

Beispiel

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

Set-CsNetworkConfiguration -EnableBandwidthPolicyCheck $True

Mit dem Befehl in diesem Beispiel wird die gesamte Anrufsteuerungskonfiguration überprüft und die Anrufsteuerung dann (je nach Ihren Reaktionen auf zurückgegebene Warnungen) aktiviert. Wenn die Anrufsteuerung bereits aktiviert ist (d. h. die Eigenschaft "EnableBandwidthPolicyCheck" weist den Wert "True" auf) und Sie diesen Befehl ausführen, wird lediglich die Überprüfung ausgeführt.