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.