Compartilhar via

  • Artigo

Set-CsNetworkInterRegionRoute

 

Tópico modificado em: 2012-03-27

Modifica uma rota existente que conecta regiões de rede em uma configuração de controle de admissão de chamadas (CAC).

Sintaxe

Set-CsNetworkInterRegionRoute [-Identity <XdsGlobalRelativeIdentity>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-NetworkRegionID1 <String>] [-NetworkRegionID2 <String>] [-NetworkRegionLinkIDs <String>] [-NetworkRegionLinks <PSListModifier>] [-WhatIf [<SwitchParameter>]]

Set-CsNetworkInterRegionRoute [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-NetworkRegionID1 <String>] [-NetworkRegionID2 <String>] [-NetworkRegionLinkIDs <String>] [-NetworkRegionLinks <PSListModifier>] [-WhatIf [<SwitchParameter>]]

Descrição Detalhada

Toda região em uma configuração CAC deve ter uma forma de acessar todas as outras regiões. Enquanto os links de regiões definem limitações de largura de banda nas conexões entre regiões e também representam os links físicos, uma rota determina qual caminho vinculado a conexão irá transpor de uma região para a outra. Esse cmdlet modifica aquela associação da rota.

Quem pode executar este cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet Set-CsNetworkInterRegionRoute localmente: RTCUniversalServerAdmins. Para retornar uma lista de todas as funções do RBAC (controle de acesso baseado na função) atribuídas a este cmdlet (incluindo eventuais funções personalizadas do RBAC que você mesmo tenha criado), execute o comando a seguir no prompt do Windows PowerShell:

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

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Opcional

XdsGlobalRelativeIdentity

O identificador único para a rota da região de rede que você quer modificar. As rotas de regiões de rede são criadas apenas em escopo global, então o identificador não precisa especificar um escopo. Em vez disso, ele contém uma cadeia de caracteres que é um nome único para identificação da rota.

Instance

Opcional

InterNetworkRegionRouteType

Uma referência de objeto a uma rota de região existente. Este objeto tem que ser do tipo Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.InterNetworkRegionRouteType, o qual pode ser recuperado chamando-se o cmdlet Get-CsNetworkInterRegionRoute.

NetworkRegionID1

Opcional

Cadeia de caracteres

A Identity (NetworkRegionID) de uma das duas regiões conectadas através dessa rota. O valor passado a esse parâmetro precisa ser uma região diferente do valor do parâmetro NetworkRegionID2. (Em outras palavras, você não pode encaminhar uma região a si mesma.) Além disso, a combinação de NetworkRegionID1 e NetworkRegionID2 tem que ser única (por exemplo, você não pode ter duas rotas definidas que conectam NorthAmerica e EMEA).

NetworkRegionID2

Opcional

Cadeia de caracteres

A Identity (NetworkRegionID) de uma das duas regiões conectadas através dessa rota. O valor passado a esse parâmetro precisa ser uma região diferente do valor do parâmetro NetworkRegionID1. (Em outras palavras, você não pode encaminhar uma região a si mesma.) Além disso, a combinação de NetworkRegionID1 e NetworkRegionID2 tem que ser única (por exemplo, você não pode ter duas rotas definidas que conectam NorthAmerica e EMEA).

NetworkRegionLinkIDs

Opcional

Cadeia de caracteres

Permite que você especifique todos os links para essa rota como uma cadeia de caracteres de valores separados por vírgula. Os valores são as identidades (NetworkRegionLinkIDs) dos links da região. Se você digitar valores tanto para NetworkRegionLinkIDs quanto para NetworkRegionLinks, NetworkRegionLinkIDs vai ser ignorado. Quaisquer links modificados usando este parâmetro vão substituir todos os links existentes na rota.

NetworkRegionLinks

Opcional

PSListModifier

Um objeto lista contendo as identidades (NetworkRegionLinkIDs) dos links da região que se aplicam à esta rota. Para esse cmdlet, esse parâmetro difere de NetworkRegionLinkIDs em que, além de poder substituir todos os links existentes para esta rota, você pode também adicionar ou remover links individuais.

Force

Opcional

SwitchParameter

Suprime todos os avisos de confirmação que seriam exibidos antes que as alterações sejam feitas.

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.InterNetworkRegionRouteType. Aceita entrada canalizada de objetos de rota inter-região de rede.

Tipos de Retorno

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

Exemplo

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

Set-CsNetworkInterRegionRoute -Identity NA_APAC_Route -NetworkRegionLinkIDs "NA_SA,SA_APAC"

Esse exemplo modifica a rota NA_APAC_Route, mudando aos links da região que serão atravessadas ao longo da rota. O parâmetro NetworkRegionLinkIDs é usado com o valor de “NA_SA,SA_APAC”, o qual substitui quaisquer links existentes com os dois especificados naquela cadeia de caracteres.

-------------------------- Exemplo 2 --------------------------

Set-CsNetworkInterRegionRoute -Identity NA_APAC_Route -NetworkRegionLinks @{add="SA_EMEA"}

Como o Exemplo 1, o Exemplo 2 modifica os links dentro da rota NA_APAC_Route. Neste exemplo, entretanto, em vez de substituir todos os links para aquela rota usando o parâmetro NetworkRegionLinkIDs, o parâmetro NetworkRegionLinks é usado para adicionar um link à lista de links que já existe naquela rota. Nesse caso, o link SA_EMEA é adicionado à rota. A sintaxe @{add=<link>} adiciona um elemento à lista de links. Você pode também usar a sintaxe @{replace=<link>} para substituir todos os links existentes por aqueles especificados por <link> (que essencialmente se comporta da mesma forma que usando NetworkRegionLinkIDs), ou a sintaxe @{remove=<link>} para remover um link da lista.

-------------------------- Exemplo 3 --------------------------

Set-CsNetworkInterRegionRoute -Identity NA_Route5 -NetworkRegionID2 SouthAmerica -NetworkRegionLinkIDs "NA_SA,SA_APAC"

O Exemplo 3 modifica a rota chamada NA_Route5. Este exemplo muda uma das regiões que compõem esta rota. O parâmetro NetworkRegionID2 é usado para especificar a nova região, então o parâmetro NetworkRegionLinkIDs é usado para criar uma nova lista de links para conectar as regiões desta rota.