Compartilhar via

  • Artigo

New-CsNetworkRegionLink

 

Tópico modificado em: 2012-03-25

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

Sintaxe

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

New-CsNetworkRegionLink -NetworkRegionID1 <String> -NetworkRegionID2 <String> -NetworkRegionLinkID <String> [-BWPolicyProfileID <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Descrição Detalhada

Regiões dentro de uma rede são vinculadas por conectividade WAN física. Este cmdlet define um link entre duas regiões e define as limitações de largura de banda em conexões de áudio e vídeo entre essas regiões.

Quem pode executar este cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet New-CsNetworkRegionLink 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 "New-CsNetworkRegionLink"}

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Obrigatório

XdsGlobalRelativeIdentity

Um identificador exclusivo para o link de região de rede recém-criado. Links 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 do link.

NetworkRegionID1

Obrigatório

Cadeia de caracteres

A identidade (NetworkRegionID) da região que está vinculada à região identificada pelo parâmetro NetworkRegionID2.

NetworkRegionID2

Obrigatório

Cadeia de caracteres

A identidade (NetworkRegionID) da região que está vinculada à região identificada pelo parâmetro NetworkRegionID1.

NetworkRegionLinkID

Obrigatório

Cadeia de caracteres

O valor é o mesmo da Identity. Você não pode especificar tanto uma Identity quanto um NetworkRegionLinkID; o valor digitado para um será usado automaticamente para ambos.

BWPolicyProfileID

Opcional

Cadeia de caracteres

A identidade do perfil de diretiva de largura de banda que definirá as limitações de largura de banda do link. Para recuperar uma lista de perfis disponíveis, chame o cmdlet Get-CsNetworkBandwidthPolicyProfile.

Force

Opcional

SwitchParameter

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

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

Este cmdlet cria um objeto do tipo Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.NetworkRegionLinkType.

Exemplo

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

New-CsNetworkRegionLink -Identity NA_EMEA -NetworkRegionID1 NorthAmerica -NetworkRegionID2 EMEA -BWPolicyProfileID LowBWLimits

Este exemplo cria um novo link de região de rede chamado NA_EMEA para vincular as regiões NorthAmerica e EMEA. O link de região é especificado como o valor do parâmetro Identity. (Ele será atribuído automaticamente como valor de NetworkRegionLinkID.) As duas regiões de rede que estão sendo vinculadas são parâmetros exigidos para a criação do link. Neste caso, as regiões se chamam NorthAmerica e EMEA. No exemplo, também atribuímos um valor ao parâmetro BWPolicyProfile. Isso irá atribuir as limitações de largura de banda definidas no perfil de diretiva de largura de banda (LowBWLimits) para conexões entre essas regiões. Se nenhum BWPolicyProfileID for fornecido, não haverá limitações nas conexões entre essas duas regiões. (ainda podem haver limitações entre sites. para detalhes, consulte o tópico de Ajuda New-CsNetworkSite).