Share via

  • Articolo

New-CsNetworkInterSitePolicy

 

Ultima modifica dell'argomento: 2012-03-27

Crea un nuovo criterio intersito di rete per definire i limiti della larghezza di banda tra siti collegati direttamente all'interno di una configurazione del servizio Controllo di ammissione di chiamata.

Sintassi

New-CsNetworkInterSitePolicy -Identity <XdsGlobalRelativeIdentity> -NetworkSiteID1 <String> -NetworkSiteID2 <String> [-BWPolicyProfileID <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

New-CsNetworkInterSitePolicy -InterNetworkSitePolicyID <String> -NetworkSiteID1 <String> -NetworkSiteID2 <String> [-BWPolicyProfileID <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Descrizione dettagliata

Se due siti di rete condividono un collegamento diretto, è possibile definire dei limiti della larghezza di banda per le connessioni audio e video tra tali siti. Questo cmdlet consente di creare un criterio di sito di rete con cui un criterio di limite di larghezza di banda viene associato a due siti connessi direttamente.

Utenti autorizzati a eseguire il cmdlet: per impostazione predefinita, sono autorizzati a eseguire localmente il cmdlet New-CsNetworkInterSitePolicy 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 "New-CsNetworkInterSitePolicy"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Obbligatorio

XdsGlobalRelativeIdentity

Un identificatore univoco per il criterio intersito di rete appena creato. I criteri intersito di rete vengono creati solo nell'ambito globale, pertanto con questo identificatore non è necessario specificare un ambito. Contiene invece una stringa composta da un nome univoco che identifica il criterio di sito.

InterNetworkSitePolicyID

Obbligatorio

Stringa

Questo valore è identico a Identity. Non è possibile specificare un valore sia per Identity sia per InterNetworkSitePolicyID; il valore immesso per l'uno verrà automaticamente utilizzato anche per l'altro.

NetworkSiteID1

Obbligatorio

Stringa

l'identità (NetworkSiteID) di uno dei due siti associati a questo criterio. La combinazione di NetworkSiteID1 e NetworkSiteID2 deve essere univoca (ad esempio, non è possibile definire due criteri di sito che collegano Reno e Portland).

NetworkSiteID2

Obbligatorio

Stringa

l'identità (NetworkSiteID) di uno dei due siti associati a questo criterio. La combinazione di NetworkSiteID1 e NetworkSiteID2 deve essere univoca (ad esempio, non è possibile definire due criteri di sito che collegano Reno e Portland).

BWPolicyProfileID

Facoltativo

Stringa

l'identità del profilo del criterio di larghezza di banda che definisce i limiti del criterio di sito. È possibile recuperare un elenco dei profili disponibili chiamando il cmdlet Get-CsNetworkBandwidthPolicyProfile.

Force

Facoltativo

Parametro opzionale

Elimina qualsiasi richiesta di conferma che, in caso contrario, sarebbe visualizzata prima di effettuare le modifiche.

InMemory

Facoltativo

Parametro opzionale

Crea un riferimento a un oggetto senza eseguire realmente il commit dell'oggetto come modifica permanente. Se si assegna l'output del cmdlet chiamato con questo parametro a una variabile, è possibile apportare modifiche alle proprietà del riferimento all'oggetto e quindi eseguire il commit di queste modifiche chiamando il cmdlet Set- corrispondente.

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

Nessuno.

Tipi restituiti

Consente di creare un oggetto di tipo Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.InterNetworkSitePolicyType.

Esempio

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

New-CsNetworkInterSitePolicy -Identity Reno_Portland -NetworkSiteID1 Reno -NetworkSiteID2 Portland -BWPolicyProfileID LowBWLimits

In questo esempio viene creato un nuovo criterio intersito di rete per limitare la larghezza di banda tra i siti connessi Reno e Portland. I limiti della larghezza di banda per le connessioni audio e video tra i due siti sono basati sull'impostazione configurata per il profilo del criterio di larghezza di banda LowBWLimits.