Condividi tramite

  • Articolo

Get-CsNetworkRegionLink

 

Ultima modifica dell'argomento: 2012-03-23

Recupera uno o più collegamenti tra regioni di rete configurate per il Controllo di ammissione di chiamata.

Sintassi

Get-CsNetworkRegionLink [-Identity <XdsGlobalRelativeIdentity>] [-LocalStore <SwitchParameter>]

Get-CsNetworkRegionLink [-Filter <String>] [-LocalStore <SwitchParameter>]

Descrizione dettagliata

Le regioni all'interno di una rete sono collegate tramite connettività fisica WAN. Questo cmdlet recupera uno o più collegamenti di aree definiti nelle impostazioni di configurazione della rete per una distribuzione di Microsoft Lync Server 2010.

Utenti autorizzati a eseguire il cmdlet: per impostazione predefinita, sono autorizzati a eseguire localmente il cmdlet Get-CsNetworkRegionLink i membri dei seguenti gruppi: RTCUniversalUserAdmins, RTCUniversalServerAdmins. Per restituire un elenco di tutti i ruoli RBAC 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 "Get-CsNetworkRegionLink"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Facoltativo

XdsGlobalRelativeIdentity

L'identificatore univoco del collegamento delle regioni di rete che si desidera recuperare. I collegamenti delle regioni di rete vengono creati esclusivamente nell'ambito globale, quindi l'identificatore non richiede la specificazione di un ambito. Contiene invece una stringa con un nome univoco che identifica il collegamento. Questo valore è lo stesso di NetworkRegionLinkID.

Filter

Facoltativo

Stringa

Accetta una stringa di caratteri jolly che viene utilizzata per recuperare collegamenti di rete in base alla corrispondenza del valore dell'identità con la stringa di caratteri jolly.

LocalStore

Facoltativo

Parametro opzionale

Recupera le informazioni relative ai collegamenti di aree della rete dalla replica locale dell'archivio di gestione centrale anziché dall'archivio di gestione centrale stesso.

Tipi di input

Nessuno.

Tipi restituiti

Recupera uno o più oggetti di tipo Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.NetworkRegionLinkType.

Esempio

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

Get-CsNetworkRegionLink

Nell'esempio 1 vengono recuperati tutti i collegamenti di aree della rete definiti in una distribuzione di Lync Server 2010.

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

Get-CsNetworkRegionLink -Identity NA_EMEA

Nell'esempio 2 vengono recuperate informazioni relative (al massimo) a un solo collegamento dell'area della rete e, più specificamente, al collegamento con l'identità NA_EMEA.

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

Get-CsNetworkRegionLink -Filter *EMEA*

In questo esempio viene utilizzato il parametro Filter per recuperare tutti i collegamenti dell'area della rete il cui nome (identità) contiene la stringa EMEA. Notare i caratteri *, prima e dopo la stringa EMEA. Questo significa che la stringa può essere preceduta o seguita da qualsiasi carattere; l'importante è che l'identità includa la stringa EMEA. In tal modo, verranno recuperati collegamenti con nomi quali, ad esempio, NA_EMEA, EMEA_APAC e EMEA2_SA.

-------------------------- Esempio 4 --------------------------

Get-CsNetworkRegionLink | Where-Object {$_.NetworkRegionID1 -eq "EMEA" -or $_.NetworkRegionID2 -eq "EMEA"}

In questo esempio vengono recuperati tutti i collegamenti delle regioni della rete che includono EMEA come una delle due regioni da collegare. Nell'esempio viene innanzitutto chiamato Get-CsNetworkRegionLink senza alcun parametro. In tal modo, verranno recuperati tutti i collegamenti di aree. La raccolta di collegamenti viene quindi inviata tramite pipe al cmdlet Where-Object. Where-Object esamina, uno per uno, i membri della raccolta, verificando i valori delle proprietà NetworkRegionID1 e NetworkRegionID2. Se una di queste proprietà è uguale a EMEA, ossia se NetworkRegionID1 è uguale a (-eq) EMEA o (-or) NetworkRegionID2 è uguale a (-eq) EMEA, l'elemento verrà mantenuto nella raccolta e visualizzato.