Compartilhar via

  • Artigo

New-CsNetworkInterRegionRoute

 

Tópico modificado em: 2012-03-27

Cria uma nova rota que conecta as regiões de rede dentro de uma configuração de controle de admissão de chamadas (CAC).

Sintaxe

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

New-CsNetworkInterRegionRoute -InterNetworkRegionRouteID <String> -NetworkRegionID1 <String> -NetworkRegionID2 <String> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-NetworkRegionLinkIDs <String>] [-NetworkRegionLinks <PSListModifier>] [-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 cria a associação da rota.

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

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

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Obrigatório

XdsGlobalRelativeIdentity

Um identificador exclusivo da rota de região de rede recém-criada. 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.

InterNetworkRegionRouteID

Obrigatório

Cadeia de caracteres

Este valor é o mesmo que a Identidade. Não é possível especificar uma Identidade e uma InterNetworkRegionRouteID; o valor digitado para um será automaticamente utilizado em ambas.

NetworkRegionID1

Obrigatório

Cadeia de caracteres

A Identidade (NetworkRegionID) de uma das duas regiões conectadas através dessa rota. O valor passado a este parâmetro deve ser uma região diferente do valor do parâmetro NetworkRegionID2. (em outras palavras, não é possível encaminhar uma região para si própria.) Além disso, a combinação de NetworkRegionID1 e NetworkRegionID2 deve ser exclusiva (por exemplo, não é possível que haja duas rotas definidas conectando NorthAmerica e EMEA).

NetworkRegionID2

Obrigatório

Cadeia de caracteres

A Identidade (NetworkRegionID) de uma das duas regiões conectadas através dessa rota. O valor passado a este parâmetro deve ser uma região diferente do valor do parâmetro NetworkRegionID1. (em outras palavras, não é possível encaminhar uma região para si própria). Além disso, a combinação de NetworkRegionID1 e NetworkRegionID2 deve ser exclusiva (por exemplo, não é possível que haja duas rotas definidas conectando NorthAmerica e EMEA).

NetworkRegionLinkIDs

Opcional

Cadeia de caracteres

Permite especificar todos os vínculos dessa rota como uma cadeia de caracteres de valores separados por vírgulas. Os valores são as identidades (NetworkRegionLinkIDs) dos vínculos da região. Se você digitar valores para NetworkRegionLinkIDs e NetworkRegionLinks, NetworkRegionLinkIDs será ignorado. Este parâmetro fornece um modo conveniente de especificar a lista de vínculos, dispensando a criação de um objeto de lista e o seu repasse ao parâmetro NetworkRegionLinks.

NetworkRegionLinks

Opcional

PSListModifier

Uma lista de objetos contendo as identidades (NetworkRegionLinkIDs) dos vínculos de região que se aplicam a essa rota. Para esse cmdlet, este parâmetro difere do NetworkRegionLinkIDs apenas no formato, se for digitado mais de um vínculo. O parâmetro NetworkRegionLinkIDs é o método recomendado para definir a lista inicial com esse cmdlet.

Force

Opcional

SwitchParameter

Elimina quaisquer prompts de confirmação que possam ser exibidos antes de realizar as alterações.

InMemory

Opcional

SwitchParameter

Cria uma referência de objeto, sem na verdade executar o objeto como uma alteração permanente. Se a saída deste cmdlet for atribuída, chamando-o com este parâmetro a uma variável, você poderá realizar alterações às propriedades da referência do objeto e executar estas alterações, chamando-se o cmdlet coincidente Set- deste cmdlet.

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

Nenhuma.

Tipos de Retorno

Cria um objeto do tipo Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.InterNetworkRegionRouteType.

Exemplo

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

New-CsNetworkInterRegionRoute -Identity NA_APAC_Route -NetworkRegionID1 NorthAmerica -NetworkRegionID2 APAC -NetworkRegionLinkIDs "NA_EMEA,EMEA_APAC"

O Exemplo 1 cria uma nova rota de região de rede entre as regiões NorthAmerica e APAC. Atribui-se a essa nova rota a identidade NA_APAC_Route. (ela será atribuída automaticamente como o InterNetworkRegionRouteID.) As regiões sendo conectadas são NorthAmerica, que é passada como valor ao parâmetro NetworkRegionID1, e APAC, que é passada como valor ao parâmetro NetworkRegionID2. Neste exemplo, assumimos que não haja vínculos de região configurados para vincular NorthAmerica diretamente a APAC. Entretanto, existem vínculos de NorthAmeria a EMEA (NA_EMEA) e de EMEA a APAC (EMEA_APAC). Usamos os vínculos, separados por vírgulas, como valor do parâmetro NetworkRegionLinkIDs. Isso irá encaminhar as conexões entre NorthAmerica e APAC através de EMEA e aplicará as limitações de largura de banda às conexões de áudio e vídeo associadas a esses links.