Set-CsNetworkSite
Ultima modifica dell'argomento: 2012-03-26
Modifica un sito di rete esistente definito per il servizio Controllo di ammissione di chiamata (CAC) o per E9-1-1 (Enhanced 9-1-1).
Sintassi
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>]]
Descrizione dettagliata
I siti di rete sono gli uffici o le località configurate in ogni area geografica di una distribuzione CAC o E9-1-1. Questo cmdlet consente di modificare le impostazioni di un sito esistente, ad esempio l'area a cui è associato il sito, la descrizione del sito e il profilo dei criteri di larghezza di banda associato.
Utenti autorizzati a eseguire questo cmdlet: per impostazione predefinita, i membri dei gruppi seguenti sono autorizzati ad eseguire il cmdlet Set-CsNetworkSite in locale: RTCUniversalServerAdmins. Per restituire un elenco di tutti i ruoli RBAC (Role-Based Access Control, controllo dell'accesso basato sui ruoli) a cui è stato assegnato questo cmdlet (compresi eventuali ruoli RBAC personalizzati creati autonomamente), eseguire il cmdlet riportato di seguito dal prompt di Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsNetworkSite"}
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
Identity |
Facoltativo |
XdsGlobalRelativeIdentity |
Identificatore univoco del sito di rete da modificare. I siti vengono creati solo nell'ambito globale, pertanto non è necessario specificare un ambito. In realtà, è sufficiente specificare l'ID del sito di rete. |
Instance |
Facoltativo |
DisplayNetworkSiteType |
Riferimento a un oggetto sito di rete (un oggetto di tipo Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.DisplayNetworkSiteType). Questo oggetto può essere recuperato chiamando il cmdlet Get-CsNetworkSite. |
BWPolicyProfileID |
Facoltativo |
Stringa |
Identità del profilo dei criteri per la larghezza di banda che definirà le limitazioni per questo sito. È possibile recuperare un elenco dei profili disponibili chiamando il cmdlet Get-CsNetworkBandwidthPolicyProfile. Se si specifica un valore per questo parametro, è necessario specificare anche un valore per il parametro NetworkRegionID. |
BypassID |
Facoltativo |
Stringa |
Identificatore univoco globale (GUID) Questo GUID è utilizzato per mappare i siti di rete alle impostazioni di bypass multimediale con una configurazione di rete CAC o E9-1-1. Utilizzare questo valore BypassID nella chiamata a New-CsNetworkMediaBypassConfiguration. Se si specifica un valore per questo parametro, è necessario specificare anche un valore per il parametro NetworkRegionID. Se non si specifica un valore per questo parametro ma si specifica un NetworkRegionID, viene generato automaticamente un BypassID. Se si specifica un valore in modo esplicito, il valore deve essere nel formato GUID (ad esempio, 3b24a047-dce6-48b2-9f20-9fbff17ed62a). È consigliabile specificare un valore per NetworkRegionID e consentire la generazione automatica del valore BypassID. Se si immette un valore manualmente, verrà visualizzata una richiesta di conferma per verificare che l'utente non desideri la generazione automatica del valore. |
Description |
Facoltativo |
Stringa |
Stringa che descrive il sito. Questo parametro può essere utilizzato per fornire una spiegazione dello scopo o della posizione del sito più descrittiva di quanto non possa essere espresso con il solo parametro Identity. |
LocationPolicy |
Facoltativo |
Stringa |
Nome dei criteri percorso associati a questo sito. I criteri percorso assegnano specifiche impostazioni per le chiamate di emergenza al sito. Per recuperare un elenco dei criteri percorso, chiamare il cmdlet Get-CsLocationPolicy. |
NetworkRegionID |
Facoltativo |
Stringa |
L'identità della regione di rete a cui è associato questo sito. Questo parametro deve contenere un valore se si desidera fornire un BypassID (manualmente o tramite la generazione automatica) o se la proprietà EnableBandwidthPolicyCheck della configurazione della rete è impostata su True. È possibile recuperare le impostazioni di configurazione della rete chiamando il cmdlet Get-CsNetworkConfiguration. Se in questo sito esiste già un BypassID e non si specifica un valore per il parametro BypassID, il BypassID esistente viene sovrascritto da un BypassID generato automaticamente. |
Force |
Facoltativo |
Parametro opzionale |
Elimina qualsiasi richiesta di conferma che, in caso contrario, sarebbe visualizzata prima di effettuare le modifiche. |
WhatIf |
Facoltativo |
Parametro opzionale |
Descrive ciò che accadrebbe se si eseguisse il comando senza eseguirlo realmente. |
Confirm |
Facoltativo |
Parametro opzionale |
Viene visualizzata una richiesta di conferma prima di eseguire il comando. |
Tipi di input
Oggetto Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.DisplayNetworkSiteType. Consente di accettare l'input da pipeline di oggetti sito di rete.
Tipi restituiti
Questo cmdlet non restituisce un valore. Modifica un oggetto di tipo Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.DisplayNetworkSiteType.
Esempio
-------------------------- Esempio 1 --------------------------
Set-CsNetworkSite -Identity Vancouver -NetworkRegionID Canada
Con questo esempio viene modificato il sito di rete denominato Vancouver. Il nome del sito da modificare viene specificato come valore del parametro Identity. Il sito Vancouver viene spostato in una nuova area geografica, in questo caso Canada, quindi è necessario modificare il parametro NetworkRegionID. Dal momento che è stato fornito un NetworkRegionID ma che non è stato specificato un valore per BypassID, il valore di BypassID viene generato automaticamente. Un eventuale ID di bypass esistente sarà sovrascritto.
-------------------------- Esempio 2 --------------------------
Set-CsNetworkSite -Identity Vancouver - BWPolicyProfileID LowBWLimits
Con l'esempio 2 viene modificato il profilo dei criteri di larghezza di banda associato al sito Vancouver. Il nome del sito viene specificato come valore del parametro Identity. Viene quindi specificato un valore per il parametro BWPolicyProfileID: LowBWLimits. Per questo sito saranno utilizzati i criteri associati a tale profilo.