• Artikel

New-CsNetworkRegion

 

Letztes Änderungsdatum des Themas: 2012-03-26

Erstellt eine neue Netzwerkregion. Netzwerkregionen repräsentieren Netzwerkhubs oder Backbones in einem Unternehmensnetzwerk.

Syntax

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

New-CsNetworkRegion -CentralSite <String> -NetworkRegionID <String> [-AudioAlternatePath <$true | $false>] [-BWAlternatePaths <PSListModifier>] [-BypassID <String>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-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. Als zentraler Standort bezeichnet man hierbei den Datencenterstandort, an dem der Bandbreitenrichtliniendienst für die Anrufsteuerung ausgeführt wird. Verwenden Sie dieses Cmdlet für das Erstellen einer neuen Netzwerkregion. Mit den Parametern dieses Cmdlets können Einstellungen bereitgestellt werden, die festlegen, ob für Audio- und Videoverbindungen alternative Pfade über das Internet zulässig sind. Darüber hinaus kann mit ihnen automatisch die ID für die Umgehung erstellt werden.

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

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Erforderlich

XdsGlobalRelativeIdentity

Eine eindeutige ID für die neu erstellte Netzwerkregion. Regionen werden ausschließlich auf globaler Ebene erstellt, sodass mit dieser ID kein Gültigkeitsbereich festgelegt werden muss. Stattdessen ist eine Zeichenfolge enthalten, die den eindeutigen Namen zur Identifizierung dieser Region darstellt.

CentralSite

Erforderlich

Zeichenfolge

Gibt den zentraler Standort an, an dem der Bandbreitenrichtliniendienst ausgeführt wird. Dieser Dienst muss aktiviert sein, damit Sie die Anrufsteuerung verwenden können. Dieser Dienst wird auf dem Front-End-Server oder dem Standard Edition-Server ausgeführt.

NetworkRegionID

Erforderlich

Zeichenfolge

Dieser Wert ist mit "Identity" identisch. Es können nicht gleichzeitig ein Identitätswert und der Parameter "NetworkRegionID" angegeben werden. Ein Wert, der für einen der beiden Parameter angegeben wird, gilt automatisch für beide.

AudioAlternatePath

Optional

Boolescher Wert

Dieser Parameter bestimmt, ob Audioanrufe über einen alternativen Pfad weitergeleitet werden, wenn der primäre Pfad keine angemessene Bandbreite bietet.

Dieser Parameter füllt die Eigenschaft "BWAlternatePaths" auf. Der für diesen Parameter bereitgestellte Wert wird in der Eigenschaft "AlternatePath" für das alternative Pfadelement gespeichert, wobei "BWPolicyModality" den Wert "Audio" aufweist.

Wenn Sie einen Wert für diesen Parameter bereitstellen, können Sie keinen Wert für den Parameter "BWAlternatePaths" angeben.

Standard: "True". Legen Sie diesen Parameter nur dann auf "False" fest, wenn alternative Pfade im Internet deaktiviert werden müssen. Falls Ihre Anrufe auch Internetanrufe umfassen, muss der Wert unabhängig von den Bandbreiteneinstellungen "True" sein.

BWAlternatePaths

Optional

PSListModifier

Eine Liste von Objekten mit Informationen darüber, ob alternative Internetverbindungspfade zulässig sind, wenn eine Medienanforderung nicht entlang des bevorzugten Pfads abgeschlossen werden kann (z. B. wenn die Grenzwerte für diesen Pfad überschritten wurden). Alternative Pfadobjekte müssen durch Aufrufen des Cmdlets New-CsNetworkBWAlternatePath erstellt werden.

Wenn Sie einen Wert für diesen Parameter bereitstellen, können Sie keine Werte für die Parameter "AudioAlternatePath" und "VideoAlternatePath" angeben.

Alternative Pfade für Audio und Video sind standardmäßig aktiviert (AlternatePath = True).

BypassID

Optional

Zeichenfolge

Eine GUID (Globally Unique Identifier). Mit dieser GUID können Sie Netzwerkregionen Medienumgehungseinstellungen in einer Netzwerkkonfiguration für Anrufsteuerung oder 9-1-1 (erweitert) (E9-1-1) zuordnen. (Verwenden Sie diesen Wert für "BypassID" beim Aufruf von New-CsNetworkMediaBypassConfiguration.)

Wenn Sie keinen Wert für diesen Parameter eingeben, wird automatisch ein Wert generiert. Wenn Sie dennoch einen Wert angeben, muss dieser das Format einer GUID aufweisen (z. B. "3b24a047-dce6-48b2-9f20-9fbff17ed62a"). Die automatische Generierung wird empfohlen. Wenn Sie einen Wert für diesen Parameter angeben, werden Sie in einer Meldung zur Bestätigung aufgefordert, dass Sie diesen Wert tatsächlich angeben möchten, statt ihn automatisch generieren zu lassen.

Description

Optional

Zeichenfolge

Eine Zeichenfolge, die die Region beschreibt. Mit diesem Parameter können Sie eine aussagekräftigere Erläuterung des Zwecks dieser Region bereitstellen als nur mit dem Identitätswert.

VideoAlternatePath

Optional

Boolescher Wert

Dieser Parameter bestimmt, ob Videoanrufe über einen alternativen Pfad weitergeleitet werden, wenn der primäre Pfad keine angemessene Bandbreite bietet.

Dieser Parameter füllt die Eigenschaft "BWAlternatePaths" auf. Der für diesen Parameter bereitgestellte Wert wird in der Eigenschaft "AlternatePath" für das alternative Pfadelement gespeichert, wobei "BWPolicyModality" den Wert "Video" aufweist.

Wenn Sie einen Wert für diesen Parameter bereitstellen, können Sie keinen Wert für den Parameter "BWAlternatePaths" angeben.

Standard: "True". Legen Sie diesen Parameter nur dann auf "False" fest, wenn alternative Pfade im Internet deaktiviert werden müssen. Falls Ihre Anrufe auch Internetanrufe umfassen, muss der Wert unabhängig von den Bandbreiteneinstellungen "True" sein.

Force

Optional

Switch-Parameter

Unterdrückt alle Bestätigungsaufforderungen, die andernfalls vor der Durchführung von Änderungen angezeigt würden. Wenn Sie z. B. einen Wert für den Parameter "BypassID" bereitstellen, werden Sie nicht zur Bestätigung aufgefordert.

InMemory

Optional

Switch-Parameter

Erstellt einen Objektverweis ohne einen Commit für das Objekt auszuführen und die Änderungen dadurch dauerhaft zu speichern. Wenn Sie die Ausgabe des mit diesem Parameter aufgerufenen Cmdlet einer Variablen zuweisen, können Sie die Eigenschaften des Objektverweises ändern und anschließend einen Commit für diese Änderungen ausführen, indem Sie das entsprechende Cmdlet vom Typ "Set-" aufrufen.

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

Keine.

Rückgabetypen

Erstellt ein Objekt vom Typ "Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.NetworkRegionType".

Beispiel

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

New-CsNetworkRegion -Identity NorthAmerica -Description "All North American Locations" -CentralSite Redmond-NA-MLS

In diesem Beispiel wird die neue Netzwerkregion "NorthAmerica" erstellt. Der Name der Region wird als Wert für den Parameter "Identity" festgelegt. Darüber hinaus wird ein Wert für den optionalen Parameter "Description" angegeben, mit dem diese Region als "All North American Locations" beschrieben wird. Abschließend erhält der Parameter "CentralSite" einen Namenswert des zentralen Standorts für diese Region, "Redmond-NA-MLS".

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

New-CsNetworkRegion -Identity EMEA -CentralSite Dublin-EU-Site -AudioAlternatePath $False

In diesem Beispiel wird die neue Netzwerkregion "EMEA" erstellt, die Einstellungen für einen alternativen Pfad für Audio enthält. Hierzu wird New-CsNetworkRegion aufgerufen und der Identitätswert "EMEA" übergeben. Dem erforderlichen Parameter "CentralSite" wird ein Wert zugewiesen (in diesem Beispiel lautet der Name des zentraler Standorts für diese Region "Dublin-EU-Site"), und anschließend wird der Wert "$False" an den Parameter "AudioAlternatePath" übergeben. Die Einstellung "False" für "AudioAlternatePath" gibt an, dass Audioanrufe bei unzureichender Bandbreite nicht an einen alternativen Pfad weitergeleitet, sondern einfach nicht getätigt werden.

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

$a = New-CsNetworkBWAlternatePath -BWPolicyModality "audio" -AlternatePath $False
New-CsNetworkRegion -Identity EMEA -CentralSite Dublin-EU-Site -BWAlternatePaths $a

In diesem Beispiel wird dieselbe Netzwerkregion wie in Beispiel 2 erstellt. Hier werden die Einstellungen für einen alternativen Pfad jedoch nicht mit dem Parameter "AudioAlternatePath" definiert, sondern mit dem Parameter "BWAlternatePaths". In der ersten Zeile des Beispiels wird das Cmdlet New-CsNetworkBWAlternatePath aufgerufen, um einen neuen alternativen Pfad zu erstellen. Ein alternativer Pfad weist nur zwei Eigenschaften auf: die Eigenschaft "BWPolicyModality", die entweder auf "Audio" oder "Video" (in diesem Beispiel "Audio") festgelegt werden muss, sowie die Eigenschaft "AlternatePath", die entweder auf "True" oder "False" (in diesem Beispiel "False") festgelegt werden muss. Die Ausgabe dieses Cmdlets, ein Verweis auf das soeben erstellte Objekt für den alternativen Pfad, wird der Variablen "$a" zugewiesen.

In Zeile 2 dieses Beispiels wird dieser neu erstellte alternative Pfad dazu verwendet, eine neue Netzwerkregion zu erstellen. Hierzu wird New-CsNetworkRegion aufgerufen und der Identitätswert "EMEA" übergeben. Dem erforderlichen Parameter "CentralSite" wird ein Wert zugewiesen (in diesem Beispiel lautet der Name des zentraler Standorts für diese Region "Dublin-EU-Site"). Anschließend wird die Variable "$a" mit dem soeben erstellten Objekt für den alternativen Pfad an den Parameter "BWAlternatePaths" übergeben.