Condividi tramite

  • Articolo

Remove-CsNetworkRegionLink

 

Ultima modifica dell'argomento: 2012-03-26

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

Sintassi

Remove-CsNetworkRegionLink -Identity <XdsGlobalRelativeIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Descrizione dettagliata

Le regioni all'interno di una rete sono collegate tramite connettività fisica WAN. Questo cmdlet non influisce sulle connessioni fisiche, ma rimuove il collegamento dalla configurazione CAC.

Utenti che possono eseguire questo cmdlet: per impostazione predefinita, i membri dei gruppi seguenti sono autorizzati a eseguire il cmdlet Remove-CsNetworkRegionLink in locale: RTCUniversalServerAdmins. Per restituire un elenco di tutti i ruoli del controllo di accesso basato sui ruoli (RBAC) ai quali è stato assegnato questo cmdlet (inclusi eventuali ruoli RBAC personalizzati creati dall'utente), eseguire il comando seguente dal prompt di Windows PowerShell:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsNetworkRegionLink"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Obbligatorio

XdsGlobalRelativeIdentity

L'identificatore univoco del collegamento delle regioni di rete che si desidera rimuovere. 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.

Force

Facoltativo

Parametro opzionale

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

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.NetworkRegionLinkType. Accetta l'invio tramite pipe di oggetti collegamenti dell'area di rete.

Tipi restituiti

Questo cmdlet non restituisce un valore. Consente di rimuovere un oggetto di tipo Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.NetworkRegionLinkType.

Esempio

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

Remove-CsNetworkRegionLink -Identity NA_EMEA

Nel primo esempio viene rimosso il collegamento delle regioni di rete con il parametro Identity NA_EMEA.

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

Get-CsNetworkRegionLink | Where-Object {$_.BWPolicyProfileID -eq "HighBWLimits"} | Remove-CsNetworkRegionLink

Nell'esempio 2 vengono rimossi tutti i collegamenti delle regioni di rete che utilizzano il profilo del criterio di larghezza di banda denominato HighBWLimits. Il primo cmdlet riportato nell'esempio è Get-CsNetworkRegionLink (senza alcun parametro), il quale recupererà tutti i collegamenti delle regioni. La raccolta dei collegamenti viene quindi inviata tramite pipe al cmdlet Where-Object. Il cmdlet Where-Object analizza ogni singolo membro della raccolta, controllandone il valore della proprietà BWPolicyProfileID. Se questa proprietà è uguale a (-eq) HighBWLimits, il membro interessato viene inviato tramite pipe al cmdlet Remove-CsNetworkRegionLink, il quale rimuove il collegamento.