Set-CsNetworkRegion

Syntax

Set-CsNetworkRegion [-Identity <XdsGlobalRelativeIdentity>] [-AudioAlternatePath <$true | $false>] [-BWAlternatePaths <PSListModifier>] [-BypassID <String>] [-CentralSite <String>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-VideoAlternatePath <$true | $false>] [-WhatIf [<SwitchParameter>]]

Set-CsNetworkRegion [-AudioAlternatePath <$true | $false>] [-BWAlternatePaths <PSListModifier>] [-BypassID <String>] [-CentralSite <String>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-VideoAlternatePath <$true | $false>] [-WhatIf [<SwitchParameter>]]

Detaillierte Beschreibung

Eine Netzwerkregion verbindet verschiedene Teile eines Netzwerks, das sich über verschiedene geografische Bereiche erstreckt. Jede Netzwerkregion muss einem zentraler Standort zugeordnet sein. Der zentrale Standort ist der Datencenterstandort, an dem der Bandbreitenrichtliniendienst für die Anrufsteuerung ausgeführt wird. Mit diesem Cmdlet können Sie eine vorhandene Netzwerkregion ändern – einschließlich der Einstellungen, die festlegen, ob für Audio- und Videoverbindungen alternative Pfade zulässig sind, und die die Standorte innerhalb der Region mit einer Konfiguration zur Medienumgehung in Bezug setzen.

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

Parameter

Eingabetypen

Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.NetworkRegionType-Objekt. Akzeptiert eine weitergeleitete Eingabe von Netzwerkregionsobjekten.

Rückgabetypen

Dieses Cmdlet gibt keinen Wert zurück. Mit ihm wird ein Objekt vom Typ "Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.NetworkRegionType" geändert.

Beispiel

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

Set-CsNetworkRegion -Identity NorthAmerica -Description "North American Region"

In diesem Beispiel wird die Netzwerkregion "NorthAmerica" geändert. Der Parameter "Description" erhält den Wert "North American Region". Wenn für die Region "NorthAmerica" ein Wert für "Description" vorhanden ist, überschreibt dieser Befehl ihn mit diesem Wert. Wenn kein Wert für "Description" festgelegt wurde, wird mit diesem Befehl ein Wert festgelegt.

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

Set-CsNetworkRegion -Identity EMEA -VideoAlternatePath $False

In diesem Beispiel wird die Netzwerkregion "EMEA" geändert und dieser eine neue alternative Pfadeinstellung für Video zugewiesen. Hierzu wird Set-CsNetworkRegion aufgerufen und "EMEA" als Identitätswert übergeben. Anschließend wird der Parameter "VideoAlternatePath" angegeben und der Wert "$False" übergeben. Die Einstellung "False" für "VideoAlternatePath" gibt an, dass der Videoanruf bei unzureichender Bandbreite nicht an einen alternativen Pfad weitergeleitet, sondern stattdessen einfach nicht getätigt wird.

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

$a = Get-CsNetworkRegion -Identity NorthAmerica
$a.BWAlternatePaths | foreach {Set-CsNetworkRegion -Identity Asia -BWAlternatePaths @{add=$_}}

In Beispiel 3 wird der Netzwerkregion "Asia" der gleiche Satz an alternativen Pfadeinstellungen wie der Region "NorthAmerica" zugewiesen. Die erste Zeile in diesem Beispiel ruft eine Instanz der Netzwerkregion "NorthAmerica" ab und weißt sie der Variablen "$a" zu. Die zweite Zeile ruft zunächst den Inhalt der Eigenschaft "BWAlternatePaths" und die (in der Variablen "$a" gespeicherten) Region "NorthAmerica" ab: "$a.BWAlternatePaths". Hierbei handelt es sich um eine Auflistung aller alternativer Pfadeinstellungen in der Region "NorthAmerica".

Als Nächstes wird diese Einstellungsauflistung an die foreach-Funktion weitergeleitet. "Foreach" durchläuft die Auflistung Element für Element und führt dabei die Aktionen in den folgenden geschweiften Klammern aus. In diesem Fall wird das Cmdlet Set-CsNetworkRegion mit der Identität "Asia" aufgerufen, um die Eigenschaften der Region "Asia" festzulegen. Der nächste Parameter ist "BWAlternatePaths". Sie übergeben den Wert "@{add=$_}" an diesen Parameter. Die Variable "$_" repräsentiert das aktuelle Element in der Auflistung, in diesem Fall den aktuellen alternativen Pfad. Der Teil "@{add=}" des Werts fügt dieses Element der Auflistung von "BWAlternatePaths" für die Region "Asia" hinzu.

Siehe auch

Weitere Ressourcen

New-CsNetworkRegion
Remove-CsNetworkRegion
Get-CsNetworkRegion
New-CsNetworkBWAlternatePath