Freigeben über


Set-CsNetworkSite

 

Letztes Änderungsdatum des Themas: 2012-03-26

Ändert einen vorhandenen Netzwerkstandort, der für die Anrufsteuerung oder 9-1-1 (erweitert) (E9-1-1) definiert wurde.

Syntax

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

Set-CsNetworkSite [-BWPolicyProfileID <String>] [-BypassID <String>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-LocationPolicy <String>] [-NetworkRegionID <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 werden die Einstellungen eines bestehenden Standorts geändert. Dazu gehören Einstellungen wie die Region, der der Standort zugeordnet ist, die Beschreibung des Standorts und das zugeordnete Bandbreitenrichtlinienprofil.

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

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Optional

XdsGlobalRelativeIdentity

Eine eindeutige ID des Netzwerkstandorts, der geändert werden soll. Standorte werden nur global erstellt. Sie müssen daher keinen Gültigkeitsbereich festlegen. Es genügt, wenn Sie die Netzwerkstandort-ID angeben.

Instance

Optional

DisplayNetworkSiteType

Ein Verweis auf ein Netzwerkstandortobjekt (ein Objekt vom Typ "Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.DisplayNetworkSiteType"). Dieses Objekt kann durch Aufrufen des Cmdlets Get-CsNetworkSite abgerufen werden.

BWPolicyProfileID

Optional

Zeichenfolge

Der Identitätswert des Bandbreitenrichtlinienprofils, mit dem die Beschrä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 einen Wert angeben, müssen Sie auch einen Wert für den Parameter "NetworkRegionID" angeben. Wenn Sie für diesen Parameter keinen Wert angeben, Sie jedoch einen Wert für "NetworkRegionID" festlegen, wird automatisch eine ID für die Umgehung generiert.

Wenn Sie einen Wert explizit angeben, muss dieser das Format einer GUID aufweisen (z. B. 3b24a047-dce6-48b2-9f20-9fbff17ed62a). Es wird empfohlen, einen Wert für "NetworkRegionID" anzugeben und eine automatisch Erstellung des Werts "BypassID" zuzulassen. Wenn Sie manuell einen Wert 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. Zum Abrufen einer Liste mit Ortungsrichtlinien rufen Sie das Cmdlet Get-CsLocationPolicy auf.

NetworkRegionID

Optional

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.

Wenn für diesen Standort bereits eine ID für die Umgehung vorhanden ist und Sie keinen Wert für den Parameter "BypassID" festlegen, wird die vorhandene ID für die Umgehung durch eine automatisch generierte ID für die Umgehung überschrieben.

Force

Optional

Switch-Parameter

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

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.DisplayNetworkSiteType-Objekt. Akzeptiert eine weitergeleitete Eingabe von Netzwerkstandortobjekten.

Rückgabetypen

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

Beispiel

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

Set-CsNetworkSite -Identity Vancouver -NetworkRegionID Canada

In diesem Beispiel wird der Netzwerkstandort "Vancouver" geändert. Der Name des zu ändernden Standorts wird als Wert für den Parameter "Identity" angegeben. Der Standort "Vancouver" wird in eine neue Region verschoben, sodass der Parameter "NetworkRegionID" geändert werden muss, in diesem Fall in die Region "Canada". Da zwar ein Wert für "NetworkRegionID", aber kein Wert für "BypassID" angegeben wurde, wird automatisch ein Wert für "BypassID" generiert. Eine zuvor vorhandene ID für die Umgehung wird überschrieben.

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

Set-CsNetworkSite -Identity Vancouver - BWPolicyProfileID LowBWLimits

In Beispiel 2 wird das dem Standort "Vancouver" zugeordnete Bandbreitenrichtlinienprofil geändert. Der Standortname wird als Wert für den Parameter "Identity" angegeben. Anschließend wird ein Wert für den Parameter "BWPolicyProfileID" festgelegt: LowBWLimits. Die mit diesem Profil verbundenen Richtlinien werden für diesen Standort verwendet.