Compartilhar via

  • Artigo

Set-CsNetworkRegionLink

 

Tópico modificado em: 2012-03-25

Modifica um link entre duas regiões de rede configuradas para o controle de admissão de chamadas (CAC).

Sintaxe

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

Set-CsNetworkRegionLink [-BWPolicyProfileID <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-NetworkRegionID1 <String>] [-NetworkRegionID2 <String>] [-WhatIf [<SwitchParameter>]]

Descrição Detalhada

As regiões dentro de uma rede são vinculadas por meio da conectividade Wan. Este cmdlet modifica um link entre duas regiões, permitindo a alteração das regiões que estiverem vinculadas, assim como as limitações de largura de banda em conexões de áudio e vídeo entre essas regiões.

Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet Set-CsNetworkRegionLink localmente: RTCUniversalServerAdmins. Para retornar uma lista de todas as funções de controle de acesso baseado em função (RBAC) às quais este cmdlet foi atribuído (inclusive qualquer função RBAC personalizada que tenha sido criada por você), execute o seguinte comando no prompt do Windows PowerShell:

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

Parâmetros

Parâmetro Obrigatório Digite Descrição

Identity

Opcional

XdsGlobalRelativeIdentity

O identificador exclusivo do link da região de rede que se deseja modificar. Como os links de região de rede são criados apenas no escopo global, esse identificador não precisa especificar um escopo. Em vez disto, ele contém uma cadeia de caracteres, que é um nome exclusivo que identifica este link.

Instance

Opcional

NetworkRegionLinkType

Uma referência de objeto a um link de região de rede. Este objeto deve ser do tipo Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.NetworkRegionLinkType, que pode ser recuperado chamando-se Get-CsNetworkRegionLink.

BWPolicyProfileID

Opcional

Cadeia de caracteres

A Identidade do perfil da política de largura de banda que definirá as limitações a este link. É possível recuperar uma lista de perfis disponíveis, chamando-se o cmdlet Get-CsNetworkBandwidthPolicyProfile.

NetworkRegionID1

Opcional

Cadeia de caracteres

A Identidade (NetworkRegionID) da região que é vinculada à região identificada pela propriedade NetworkRegionID2.

NetworkRegionID2

Opcional

Cadeia de caracteres

A Identidade (NetworkRegionID) da região que é vinculada à região identificada pela propriedade NetworkRegionID1.

Force

Opcional

SwitchParameter

Suprime qualquer aviso de confirmação que, de outra maneira, seria exibido antes de se realizar as alterações.

WhatIf

Opcional

SwitchParameter

Descreve o que aconteceria se o comando fosse executado sem ser executado de fato.

Confirm

Opcional

SwitchParameter

Solicita confirmação antes da execução do comando.

Tipos de Entrada

Objeto Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.NetworkRegionLinkType. Aceita entradas canalizadas dos objetos de link de região de rede.

Tipos de Retorno

Este cmdlet não retorna um valor. Ele modifica um objeto do tipo Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.NetworkRegionLinkType.

Exemplo

-------------------------- Exemplo 1 --------------------------

Set-CsNetworkRegionLink -Identity NA_EMEA -BWPolicyProfileID HighBWLimits

Este exemplo altera o perfil da política de largura de banda do link da região de rede denominado NA_EMEA para o perfil HighBWLimits. O nome do link da região de rede que queremos modificar é especificado como o valor do parâmetro Identidade. Depois, atribuímos o valor HighBWLimits ao parâmetro BWPolicyProfile. Isto atribuirá as limitações de largura de banda definidas neste perfil de política de largura de banda (HighBWLimits) a conexões entre estas regiões.