Condividi tramite

  • Articolo

Set-CsNetworkConfiguration

 

Ultima modifica dell'argomento: 2012-03-27

Modifica le impostazioni per una configurazione di rete. Questo cmdlet verrà utilizzato più frequentemente per abilitare o disabilitare il servizio Controllo di ammissione di chiamata.

Sintassi

Set-CsNetworkConfiguration [-Identity <XdsIdentity>] [-BWPolicyProfiles <PSListModifier>] [-Confirm [<SwitchParameter>]] [-EnableBandwidthPolicyCheck <$true | $false>] [-Force <SwitchParameter>] [-InterNetworkRegionRoutes <PSListModifier>] [-InterNetworkSitePolicies <PSListModifier>] [-MediaBypassSettings <MediaBypassSettingsType>] [-NetworkRegionLinks <PSListModifier>] [-NetworkRegions <PSListModifier>] [-NetworkSites <PSListModifier>] [-Subnets <PSListModifier>] [-WhatIf [<SwitchParameter>]]

Set-CsNetworkConfiguration [-BWPolicyProfiles <PSListModifier>] [-Confirm [<SwitchParameter>]] [-EnableBandwidthPolicyCheck <$true | $false>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-InterNetworkRegionRoutes <PSListModifier>] [-InterNetworkSitePolicies <PSListModifier>] [-MediaBypassSettings <MediaBypassSettingsType>] [-NetworkRegionLinks <PSListModifier>] [-NetworkRegions <PSListModifier>] [-NetworkSites <PSListModifier>] [-Subnets <PSListModifier>] [-WhatIf [<SwitchParameter>]]

Descrizione dettagliata

L'oggetto configurazione di rete contiene tutte le impostazioni per l'intera configurazione del servizio Controllo di ammissione di chiamata in una distribuzione di Microsoft Lync Server 2010 oltre alle impostazioni di bypass degli elementi multimediali. È possibile utilizzare questo cmdlet per modificare qualsiasi parte della configurazione del servizio Controllo di ammissione di chiamata ma è necessario utilizzarlo se si desidera modificare le impostazioni di bypass degli elementi multimediali. Per modificare la maggior parte delle impostazioni di configurazione del servizio, è consigliabile tuttavia utilizzare i cmdlet specifici per il tipo di oggetto. Per gestire, ad esempio, le aree di rete, utilizzare i cmdlet che finiscono con CsNetworkRegion anziché modificare il parametro NetworkRegions di questo cmdlet.

Questo cmdlet viene utilizzato principalmente per abilitare (e disabilitare) il servizio Controllo di ammissione di chiamata e per applicare le impostazioni di bypass degli elementi multimediali. Dopo aver configurato i diversi componenti necessari per la configurazione (ad esempio aree, siti e subnet), è necessario abilitare la configurazione affinché possa essere utilizzata. A tale scopo, impostare semplicemente il parametro EnableBandwidthPolicyCheck su True. Si noti che l'esecuzione di questo cmdlet con EnableBandwidthPolicyCheck impostato su True non abilita immediatamente il servizio Controllo di ammissione di chiamata. Prima dell'abilitazione vengono eseguiti una serie di controlli di convalida per garantire che la configurazione sia stata completata correttamente. Gli errori o le discrepanze rilevate nella configurazione comporteranno la visualizzazione di messaggi di avviso in cui verrà chiesto se si desidera continuare l'abilitazione del servizio Controllo di ammissione di chiamata nonostante esista un problema. Se si sceglie di continuare, premendo Invio o Y, la convalida proseguirà visualizzando altri messaggi se vengono rilevati nuovi errori.

Se si esegue tutto il processo di convalida scegliendo di proseguire a ogni avviso, EnableBandwidthPolicyCheck verrà impostato su True e il servizio verrà abilitato. È probabile tuttavia che non funzionerà come previsto finché non verranno risolti gli errori. Se in qualsiasi momento durante la convalida si sceglie di interrompere il processo, digitando N al messaggio di avviso, la convalida terminerà e EnableBandwidthPolicyCheck rimarrà impostato su False (valore predefinito).

Se EnableBandwidthPolicyCheck è già impostato su True, è possibile chiamare Set-CsNetworkConfiguration e passare il valore True al parametro EnableBandwidthPolicyCheck per eseguire la convalida senza modificare le impostazioni. Quando inoltre EnableBandwidthPolicyCheck è impostato su True, qualsiasi modifica che si tenta di effettuare chiamando Set-CsNetworkConfiguration attiverà di nuovo l'esecuzione del controllo di convalida.

Utenti autorizzati a eseguire il cmdlet: per impostazione predefinita, sono autorizzati a eseguire localmente il cmdlet Set-CsNetworkConfiguration i membri dei seguenti gruppi: RTCUniversalServerAdmins. Per restituire un elenco di tutti i ruoli RBAC (Role-Based Access Control) a cui è stato assegnato questo cmdlet, inclusi gli eventuali ruoli RBAC personalizzati creati dall'utente, dal prompt di Windows PowerShell eseguire il seguente comando:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsNetworkConfiguration"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Facoltativo

Identità XDS

Questo valore sarà sempre Global.

Instance

Facoltativo

NetworkConfigurationSettings

Riferimento a un oggetto configurazione di rete. Questo oggetto deve essere di tipo Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.NetworkConfigurationSettings, che può essere recuperato chiamando il cmdlet Get-CsNetworkConfiguration.

BWPolicyProfiles

Facoltativo

PSListModifier

Raccolta di tutti i profili dei criteri di larghezza di banda che possono essere assegnati a siti, criteri intersito e collegamenti aree di rete. Ogni profilo dei criteri di larghezza di banda contiene le limitazioni relative alla larghezza di banda (sia globali che di sessione) per le connessioni audio e/o video. Un elenco completo dei profili dei criteri di larghezza di banda può essere recuperato chiamando il cmdlet Get-CsNetworkBandwidthPolicyProfile.

EnableBandwidthPolicyCheck

Facoltativo

Booleano

Se questo parametro viene impostato su True, verrà un eseguito un controllo di convalida rispetto all'intera configurazione del servizio Controllo di ammissione di chiamata. Se tutti i controlli di convalida vengono superati o se si sceglie di ignorare tutti gli avvisi, il servizio Controllo di ammissione di chiamata verrà abilitato. Se un controllo di convalida non viene superato, è possibile scegliere di interrompere la convalida e in questo caso il valore di EnableBandwidthPolicyCheck non verrà modificato.

Se questo parametro viene impostato su False, il servizio Controllo di ammissione di chiamata verrà disabilitato.

Valore predefinito: False

InterNetworkRegionRoutes

Facoltativo

PSListModifier

Raccolta di tutte le route dell'area di rete definite nella configurazione del servizio Controllo di ammissione di chiamata. È possibile recuperare tutti i membri di questa raccolta chiamando il cmdlet Get-CsNetworkInterRegionRoute.

InterNetworkSitePolicies

Facoltativo

PSListModifier

Raccolta di criteri intersito di rete definiti nella configurazione del servizio Controllo di ammissione di chiamata. È possibile recuperare tutti i membri di questa raccolta chiamando il cmdlet Get-CsNetworkInterSitePolicy.

MediaBypassSettings

Facoltativo

MediaBypassSettingsType

Riferimento a un oggetto che definisce le impostazioni globali di bypass degli elementi multimediali per la configurazione del servizio Controllo di ammissione di chiamata. L'impostazione di questo valore sovrascriverà tutte le impostazioni esistenti di bypass degli elementi multimediali. Per ottenere questo riferimento all'oggetto, chiamare il cmdlet New-CsNetworkMediaBypassConfiguration e assegnare le nuove impostazioni di configurazione a una variabile. Passare questa variabile al parametro MediaBypassSettings per modificare le impostazioni globali di bypass degli elementi multimediali.

NetworkRegionLinks

Facoltativo

PSListModifier

Raccolta di collegamenti dell'area di rete definiti nella configurazione del servizio Controllo di ammissione di chiamata. Ogni collegamento dell'area di rete definisce una connessione tra due aree e le limitazioni relative alla larghezza di banda da applicare alle connessioni tra tali aree. È possibile recuperare tutti i membri di questa raccolta chiamando il cmdlet Get-CsNetworkRegionLink.

NetworkRegions

Facoltativo

PSListModifier

Raccolta di aree di rete, ciascuna delle quali rappresenta un hub o un backbone all'interno della rete, definite nella configurazione del servizio Controllo di ammissione di chiamata. È possibile recuperare tutti i membri di questa raccolta chiamando il cmdlet Get-CsNetworkRegion.

NetworkSites

Facoltativo

PSListModifier

Raccolta di siti di rete, ciascuno dei quali rappresenta un ufficio o una località all'interno di un'area, definiti nella configurazione del servizio Controllo di ammissione di chiamata. È possibile recuperare tutti i membri di questa raccolta chiamando il cmdlet Get-CsNetworkSite.

Subnets

Facoltativo

PSListModifier

Raccolta di subnet di rete (ciascuna delle quali associa un endpoint a un sito) definite nella configurazione del servizio Controllo di ammissione di chiamata. È possibile recuperare tutti i membri di questa raccolta chiamando il cmdlet Get-CsNetworkSubnet.

Force

Facoltativo

Parametro opzionale

Questo parametro non accetta un valore. Se si include questo parametro, tutte le modifiche apportate alla configurazione, compresa la relativa abilitazione, verranno implementate senza avvisi o controlli di convalida.

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.NetworkConfigurationSettings. Accetta l'input da pipeline di un oggetto di configurazione di rete.

Tipi restituiti

Set-CsNetworkConfiguration non restituisce un valore o un oggetto. Il cmdlet modifica invece le istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.NetworkConfigurationSettings.

Esempio

-------------------------- Esempio 1 --------------------------

Set-CsNetworkConfiguration -EnableBandwidthPolicyCheck $True

Il comando di questo esempio eseguirà un controllo di convalida rispetto all'intera configurazione del servizio Controllo di ammissione di chiamata e quindi, a seconda delle risposte ai messaggi di avviso restituiti, abiliterà il servizio Controllo di ammissione di chiamata. Se il servizio Controllo di ammissione di chiamata è già abilitato, ovvero se la proprietà EnableBandwidthPolicyCheck è True, e si esegue questo comando, verrà semplicemente eseguito il controllo di convalida.