Condividi tramite

  • Articolo

New-CsNetworkRegionLink

 

Ultima modifica dell'argomento: 2012-03-25

Consente di creare un collegamento tra due regioni configurate per il servizio Controllo di ammissione di chiamata (CAC).

Sintassi

New-CsNetworkRegionLink -Identity <XdsGlobalRelativeIdentity> -NetworkRegionID1 <String> -NetworkRegionID2 <String> [-BWPolicyProfileID <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

New-CsNetworkRegionLink -NetworkRegionID1 <String> -NetworkRegionID2 <String> -NetworkRegionLinkID <String> [-BWPolicyProfileID <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Descrizione dettagliata

Le regioni all'interno di una rete sono collegate tramite connessioni WAN (Wide Area Network) fisiche. Questo cmdlet consente di definire un collegamento tra due regioni e di impostare i limiti della larghezza di banda per le connessioni audio e video tra queste due regioni.

Utenti autorizzati a utilizzare questo cmdlet: per impostazione predefinita, il cmdlet New-CsNetworkRegionLink 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-CsNetworkRegionLink"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Obbligatorio

XdsGlobalRelativeIdentity

Un identificatore univoco per il collegamento di rete tra regioni appena creato. I collegamenti di rete tra regioni vengono creati solo nell'ambito globale, per cui in questo identificatore non è necessario specificare un ambito. L'identificatore contiene invece una stringa che costituisce il nome univoco di quello specifico collegamento.

NetworkRegionID1

Obbligatorio

Stringa

L'identità (NetworkRegionID) della regione collegata alla regione identificata dal parametro NetworkRegionID2.

NetworkRegionID2

Obbligatorio

Stringa

L'identità (NetworkRegionID) della regione collegata alla regione identificata dal parametro NetworkRegionID1.

NetworkRegionLinkID

Obbligatorio

Stringa

Questo valore è uguale all'identità. Non è possibile specificare valori diversi per Identity e NetworkRegionLinkID; il valore immesso per l'uno verrà automaticamente utilizzato anche per l'altro.

BWPolicyProfileID

Facoltativo

Stringa

L'identità del profilo dei criteri di larghezza di banda che definisce i limiti della larghezza di banda per questo collegamento. È possibile recuperare un elenco di profili disponibili utilizzando il cmdlet Get-CsNetworkBandwidthPolicyProfile.

Force

Facoltativo

Parametro opzionale

Consente di evitare la visualizzazione delle richieste di conferma che altrimenti verrebbero visualizzate prima che vengano apportate 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

Questo cmdlet consente di creare un oggetto di tipo Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.NetworkRegionLinkType.

Esempio

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

New-CsNetworkRegionLink -Identity NA_EMEA -NetworkRegionID1 NorthAmerica -NetworkRegionID2 EMEA -BWPolicyProfileID LowBWLimits

Questo esempio consente di creare un nuovo collegamento di rete tra regioni chiamato NA_EMEA per collegare le regioni Nord America ed EMEA. Il nome del collegamento tra regioni è specificato come valore del parametro Identity. Questo valore diventa automaticamente anche il valore del parametro NetworkRegionLinkID. Le due regioni da collegare in rete sono parametri obbligatori per la creazione del collegamento, in questo caso le regioni indicate sono il Nord America (NorthAmerica) ed EMEA. In questo esempio, è stato anche assegnato un valore al parametro BWPolicyProfile. Questo parametro consente di assegnare i limiti della larghezza di banda definiti nel profilo dei criteri di larghezza di banda (LowBWLimits) per le connessioni tra queste regioni. Se non viene fornito alcun valore per BWPolicyProfileID, significa che non esistono limiti di larghezza di banda per le connessioni tra queste due regioni. Tuttavia, potrebbero ancora esistere dei limiti tra i siti. Per informazioni dettagliate, vedere l'argomento New-CsNetworkSite nella Guida.