Freigeben über


New-CsNetworkSite

 

Letztes Änderungsdatum des Themas: 2012-03-27

Erstellt einen neuen Netzwerkstandort für die Verwendung mit der Anrufsteuerung oder 9-1-1 (erweitert) (E9-1-1).

Syntax

New-CsNetworkSite -Identity <XdsGlobalRelativeIdentity> -NetworkRegionID <String> [-BWPolicyProfileID <String>] [-BypassID <String>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-LocationPolicy <String>] [-WhatIf [<SwitchParameter>]]

New-CsNetworkSite -NetworkRegionID <String> -NetworkSiteID <String> [-BWPolicyProfileID <String>] [-BypassID <String>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-LocationPolicy <String>] [-WhatIf [<SwitchParameter>]]

Detaillierte Beschreibung

Netzwerkstandorte sind Niederlassungen oder Standorte, die in jeder Region einer Anrufsteuerungs- oder E9-1-1-Bereitstellung konfiguriert sind. Mit diesem Cmdlet wird ein neuer Standort erstellt, der optional einer Region zugeordnet wird. Eine Netzwerkregion für Nordamerika ist beispielsweise Netzwerkstandorten wie Chicago, Redmond und Vancouver zugeordnet. Ein Anrufsteuerungs-Netzwerkstandort muss für jeden Standort einer Organisation erstellt werden, selbst wenn der jeweilige Standort keine Bandbreiteneinschränkungen aufweist.

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

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Erforderlich

XdsGlobalRelativeIdentity

Eine eindeutige ID des neu erstellten Netzwerkstandorts. Standorte werden ausschließlich auf globaler Ebene erstellt, sodass mit dieser ID kein Gültigkeitsbereich festgelegt werden muss. Stattdessen ist eine Zeichenfolge enthalten, die unter allen Netzwerkstandorten in der Microsoft Lync Server 2010-Bereitstellung eindeutig ist.

NetworkRegionID

Erforderlich

Zeichenfolge

Der Identitätswert der Netzwerkregion, die diesem Standort zugeordnet ist. Dieser Parameter muss einen Wert enthalten, wenn Sie eine "BypassID" angeben möchten (entweder per automatischer Generierung oder manuell) oder die Eigenschaft "EnableBandwidthPolicyCheck" der Netzwerkkonfiguration auf "True" festgelegt ist. Sie können die Netzwerkkonfigurationseinstellungen durch Aufrufen des Cmdlets Get-CsNetworkConfiguration abrufen.

NetworkSiteID

Erforderlich

Zeichenfolge

Dieser Wert ist mit "Identity" identisch. Sie können nicht sowohl einen Wert für "Identity" als auch für "NetworkSiteID" angeben. Ein für einen Parameter eingegebener Wert wird automatisch für beide Parameter verwendet.

BWPolicyProfileID

Optional

Zeichenfolge

Der Identitätswert des Bandbreitenrichtlinienprofils, mit dem die Bandbreiteneinschränkungen für diesen Standort definiert werden. Sie können eine Liste der verfügbaren Profile durch Aufrufen des Cmdlets Get-CsNetworkBandwidthPolicyProfile abrufen.

Wenn Sie für diesen Parameter einen Wert angeben, müssen Sie auch einen Wert für den Parameter "NetworkRegionID" angeben.

BypassID

Optional

Zeichenfolge

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

Wenn Sie für diesen Parameter keinen Wert angeben, wird ein Wert automatisch generiert, jedoch nur, wenn Sie für den Parameter "NetworkRegionID" einen Wert angeben. Wenn Sie für "NetworkRegionID" keinen Wert angeben, wird kein Wert für "BypassID" generiert. Sie können ferner für den Parameter "BypassID" nicht explizit einen Wert angeben, ohne auch einen Wert für den Parameter "NetworkRegionID" anzugeben.

Wenn Sie einen Wert explizit angeben, muss dieser das Format einer GUID aufweisen (z. B. 3b24a047-dce6-48b2-9f20-9fbff17ed62a). Die automatische Generierung wird empfohlen. Wenn Sie einen Wert manuell eingeben, wird eine Bestätigungsaufforderung eingeblendet, um zu bestätigen, dass Sie diesen Wert manuell festlegen möchten.

Description

Optional

Zeichenfolge

Eine Zeichenfolge, die den Standort beschreibt. Mit diesem Parameter können Sie eine aussagekräftigere Erläuterung des Zwecks und der Lage dieses Standorts bereitstellen als nur mit dem Identitätswert.

LocationPolicy

Optional

Zeichenfolge

Der Name der Ortungsrichtlinie, die diesem Standort zugeordnet ist. Mit der Ortungsrichtlinie werden dem Standort spezifische E9-1-1-Einstellungen zugewiesen. Sie können eine Liste von Ortungsrichtlinien durch Aufrufen des Cmdlets Get-CsLocationPolicy abrufen.

Force

Optional

Switch-Parameter

Unterdrückt alle Bestätigungsaufforderungen, die andernfalls vor der Durchführung von Änderungen angezeigt würden.

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.DisplayNetworkSiteType".

Beispiel

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

New-CsNetworkSite -Identity Vancouver -NetworkRegionID NorthAmerica

In diesem Beispiel wird der neue Netzwerkstandort "Vancouver" erstellt. Der Standortname wird als Wert für den Parameter "Identity" angegeben. Ein Wert wird auch für den Parameter "NetworkRegionID" angegeben, der den Standort der Region zuordnet (beispielsweise "NorthAmerica"). Der Wert für "BypassID" wird automatisch generiert. Das manuelle Festlegen eines Werts für "BypassID" wird nicht empfohlen.

Beachten Sie, dass der Befehl in diesem Beispiel nicht den Parameter "BWPolicyProfileID" enthielt. Solange nicht mit dem Cmdlet Set-CsNetworkSite später ein Wert hinzugefügt wird, gelten für diesen Standort keine Bandbreiteneinschränkungen für Medienverbindungen.

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

New-CsNetworkSite -Identity Paris -NetworkRegionID EMEA -BWPolicyProfileID LowBWLimits

In Beispiel 2 wird der neue Netzwerkstandort "Paris" erstellt. Der Standortname wird als Wert für den Parameter "Identity" angegeben. Wie in Beispiel 1 wird auch ein Wert für "NetworkRegionID" angegeben, und zwar die Region "EMEA". Wiederum wird die empfohlene Vorgehensweise befolgt, die das Generieren der "BypassID" durch das Cmdlet vorsieht. Im Gegensatz zu Beispiel 1 wird in diesem Beispiel ein Wert für den Parameter "BWPolicyProfileID" angegeben: LowBWLimits. Die mit diesem Profil verbundenen Richtlinien werden für diesen Standort verwendet.