Compartilhar via

  • Artigo

Remove-CsNetworkInterRegionRoute

 

Tópico modificado em: 2012-03-25

Remove uma rota que conecta regiões da rede na configuração de um controle de admissão de chamadas (CAC).

Sintaxe

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

Descrição Detalhada

Cada região contida em uma configuração CAC deve ter uma forma de acessar outra região. Enquanto os vínculos de região definem limitações de largura de banda nas conexões entre regiões e representam os vínculos físicos, uma rota determina o caminho vinculado que a conexão percorrerá de uma região à outra. Este cmdlet remove uma dessas associações de rota.

Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet Remove-CsNetworkInterRegionRoute localmente: RTCUniversalServerAdmins. Para retornar uma lista de todas as funções do controle de acesso baseado em função (RBAC) que receberam a atribuição desse cmdlet (incluindo qualquer função RBAC personalizada criada por você), execute o seguinte comando do prompt Windows PowerShell:

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

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Obrigatório

XdsGlobalRelativeIdentity

O identificador exclusivo da rota da região da rede que se deseja remover. Como as rotas de região de rede são criadas 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 a rota.

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.InterNetworkRegionRouteType. Aceita entrada canalizada de objetos de rota entre regiões de rede.

Tipos de Retorno

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

Exemplo

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

Remove-CsNetworkInterRegionRoute -Identity NA_APAC_Route

O Exemplo 1 remove a rota cuja identidade for NA_APAC_Route.

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

Get-CsNetworkInterRegionRoute | Where-Object {$_.NetworkRegionID1 -eq "NorthAmerica" -or $_.NetworkRegionID2 -eq "NorthAmerica"} | Remove-CsNetworkInterRegionRoute

O Exemplo 2 remove todas as rotas de região que incluírem a região NorthAmerica. A primeira parte do comando é uma chamada ao cmdlet Get-CsNetworkInterRegionRoute. Este cmdlet, chamado sem parâmetros, recuperará todas as rotas de região. A seguir, esta coleção será canalizada para o cmdlet Where-Object. O cmdlet Where-Object restringirá a coleção apenas às rotas que tiverem NorthAmerica definida como uma de suas regiões. Ela faz isso verificando se a rota tem um valor de NetworkRegionID1 igual a (-eq) NorthAmerica ou (-or) um valor NetworkRegionID2 igual a NorthAmerica. Quando a coleção contiver apenas as rotas que incluem a região NorthAmerica, a coleção será canalizada para Remove-CsNetworkInterRegionRoute, que removerá cada uma destas rotas.