Condividi tramite

  • Articolo

New-CsNetworkRegion

 

Ultima modifica dell'argomento: 2012-03-26

Crea una nuova area di rete. Le aree di rete rappresentano hub di rete o backbone in una rete aziendale.

Sintassi

New-CsNetworkRegion -Identity <XdsGlobalRelativeIdentity> -CentralSite <String> [-AudioAlternatePath <$true | $false>] [-BWAlternatePaths <PSListModifier>] [-BypassID <String>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-VideoAlternatePath <$true | $false>] [-WhatIf [<SwitchParameter>]]

New-CsNetworkRegion -CentralSite <String> -NetworkRegionID <String> [-AudioAlternatePath <$true | $false>] [-BWAlternatePaths <PSListModifier>] [-BypassID <String>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-VideoAlternatePath <$true | $false>] [-WhatIf [<SwitchParameter>]]

Descrizione dettagliata

Una regione di rete crea una connessione tra diverse parti di una rete in più aree geografiche. Ogni area di rete deve essere associata a un sito centrale. Il sito centrale è il data center in cui viene eseguito il servizio dei criteri di larghezza di banda per Controllo di ammissione di chiamata (CAC). Utilizzare questo cmdlet per creare una nuova area di rete. I parametri di questo cmdlet consentono di specificare le impostazioni per indicare se è consentito un percorso alternativo tramite Internet per connessioni audio e video e per generare automaticamente il valore del parametro BypassID.

Utenti autorizzati a utilizzare questo cmdlet: per impostazione predefinita, il cmdlet New-CsNetworkRegion può essere utilizzato localmente dai membri dei seguenti gruppi: RTCUniversalServerAdmins. Per ottenere un elenco di tutti i ruoli RBAC (controllo dell'accesso basato sui ruoli) a cui è stato assegnato questo cmdlet (inclusi eventuali ruoli RBAC personalizzati), utilizzare il seguente comando dal prompt di Windows PowerShell:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsNetworkRegion"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Obbligatorio

XdsGlobalRelativeIdentity

Identificatore univoco per le aree di rete appena create. Le aree di rete vengono create solo nell'ambito globale, per cui questo identificatore non specifica un ambito, ma contiene invece una stringa che costituisce il nome univoco della specifica area.

CentralSite

Obbligatorio

Stringa

sito centrale in cui è in esecuzione il servizio dei criteri di larghezza di banda. Questo servizio deve essere abilitato per poter utilizzare CAC e viene eseguito nel server Front End o nel Server Standard.

NetworkRegionID

Obbligatorio

Stringa

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

AudioAlternatePath

Facoltativo

Booleano

Questo parametro determina se le chiamate audio verranno instradate su un percorso alternativo qualora la larghezza di banda del percorso primario non sia adeguata.

Questo parametro assegna un valore alla proprietà BWAlternatePaths. Il valore specificato per questo parametro viene archiviato nella proprietà AlternatePath per l'elemento percorso alternativo con il valore Audio per BWPolicyModality.

Se si specifica un valore per questo parametro, non sarà possibile specificare un valore per il parametro BWAlternatePaths.

Valore predefinito: True. Impostare questo parametro su False solo se è necessario disattivare la ripartizione del carico di lavoro in Internet. Se alcune delle chiamate vengono effettuate via Internet, questo valore deve essere True, indipendentemente dalle impostazioni della larghezza di banda.

BWAlternatePaths

Facoltativo

PSListModifier

Elenco di oggetti in cui è specificato se sono consentiti percorsi di connessione Internet alternativi qualora una richiesta multimediale non possa essere completata con il percorso preferito, ad esempio se sono stati superati i limiti impostati per tale percorso. Gli oggetti percorso alternativo devono essere creati utilizzando il cmdlet New-CsNetworkBWAlternatePath.

Se si fornisce un valore per questo parametro non sarà possibile specificare un valore sia per il parametro AudioAlternatePath sia per VideoAlternatePath.

Per impostazione predefinita, i percorsi alternativi per audio e video sono abilitati (AlternatePath = True).

BypassID

Facoltativo

Stringa

Identificatore univoco globale (GUID) utilizzato per mappare le aree di rete alle impostazioni di bypass multimediale in un Controllo di ammissione di chiamata o in una configurazione di rete E99-1 (Enhanced 9-1-1). Utilizzare questo valore BypassID nella chiamata a New-CsNetworkMediaBypassConfiguration.

Se per questo parametro non si specifica alcun valore, ne verrà generato uno automaticamente. Se si specifica un valore, deve essere nel formato di un GUID, ad esempio 3b24a047-dce6-48b2-9f20-9fbff17ed62a. La generazione automatica è la scelta consigliata. Se si specifica un valore, verrà visualizzato un messaggio in cui si richiede di confermare che si intende specificare un valore anziché consentirne la generazione automatica.

Description

Facoltativo

Stringa

Una stringa che descrive la regione. Questo parametro può essere utilizzato per fornire una descrizione più dettagliata della regione rispetto a quanto può essere fatto nella sola Identity.

VideoAlternatePath

Facoltativo

Booleano

Questo parametro determina se le chiamate video verranno instradate su un percorso alternativo qualora la larghezza di banda del percorso primario non sia adeguata.

Questo parametro assegna un valore alla proprietà BWAlternatePaths. Il valore specificato per questo parametro viene archiviato nella proprietà AlternatePath per l'elemento percorso alternativo con il valore Video per BWPolicyModality.

Se si fornisce un valore per questo parametro, non è possibile specificare un valore per il parametro BWAlternatePaths.

Valore predefinito: True. Impostare questo parametro su False solo se è necessario disattivare la ripartizione del carico di lavoro in Internet. Se alcune delle chiamate vengono effettuate via Internet, questo valore deve essere True, indipendentemente dalle impostazioni della larghezza di banda.

Force

Facoltativo

Parametro opzionale

Consente di evitare la visualizzazione delle richieste di conferma che altrimenti verrebbero visualizzate prima che vengano apportate le modifiche. Ad esempio, se si fornisce un valore per il parametro BypassID, non verrà richiesta nessuna conferma.

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.NetworkRegionType.

Esempio

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

New-CsNetworkRegion -Identity NorthAmerica -Description "All North American Locations" -CentralSite Redmond-NA-MLS

In questo esempio viene creata una nuova area di rete denominata NorthAmerica. Il nome dell'area viene specificato come valore del parametro Identity. Viene inoltre specificato un valore per il parametro facoltativo Description, che descrive quest'area come composta da tutte le regioni del Nord America ("All North American Locations"). Infine, il parametro CentralSite riceve un valore corrispondente al nome del sito centrale per quest'area, Redmond-NA-MCS.

-------------------------- Esempio 2 --------------------------

New-CsNetworkRegion -Identity EMEA -CentralSite Dublin-EU-Site -AudioAlternatePath $False

Questo esempio crea una nuova regione di rete chiamata EMEA che include le impostazioni per un percorso alternativo audio. Per ottenere questo risultato, viene utilizzato il cmdlet New-CsNetworkRegion e definita l'identità EMEA. Viene poi assegnato un valore per il parametro obbligatorio CentralSite (in questo esempio, il nome di sito centrale per questa area è Dublin-EU-Site) e specificato il valore $False per il parametro AudioAlternatePath. Impostando AudioAlternatePath su False si indica che, se non è disponibile una larghezza di banda adeguata, le chiamate audio non verranno instradate su un percorso alternativo e non verranno completate.

-------------------------- Esempio 3 --------------------------

$a = New-CsNetworkBWAlternatePath -BWPolicyModality "audio" -AlternatePath $False
New-CsNetworkRegion -Identity EMEA -CentralSite Dublin-EU-Site -BWAlternatePaths $a

In questo esempio viene creata la stessa area di rete dell'esempio 2. Tuttavia, in questo caso verrà utilizzato il parametro BWAlternatePaths anziché il parametro AudioAlternatePath per definire le impostazioni del percorso alternativo. Nella prima riga dell'esempio viene utilizzato il cmdlet New-CsNetworkBWAlternatePath per creare un nuovo percorso alternativo. Un percorso alternativo ha solo due proprietà: BWPolicyModality, impostata su Audio o Video (in questo esempio, Audio) e AlternatePath, impostata su True o False (in questo esempio, False). Viene assegnato l'output di questo cmdlet, un riferimento all'oggetto percorso alternativo appena creato, alla variabile $a.

Nella riga 2 di questo esempio viene utilizzato questo percorso alternativo appena creato quando si crea una nuova regione di rete. Per ottenere questo risultato, viene utilizzato il cmdlet New-CsNetworkRegion e definita l'identità EMEA. Viene poi assegnato un valore per il parametro obbligatorio CentralSite (in questo esempio, il nome di sito centrale per questa area è Dublin-EU-Site) e il parametro BWAlternatePaths viene impostato sulla variabile ($a) che contiene il percorso alternativo appena creato.