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.