Compartilhar via

  • Artigo

Set-CsNetworkRegion

 

Tópico modificado em: 2012-03-24

Modifica uma região de rede existente. As regiões de rede representam hubs de rede ou backbones em uma rede corporativa.

Sintaxe

Set-CsNetworkRegion [-Identity <XdsGlobalRelativeIdentity>] [-AudioAlternatePath <$true | $false>] [-BWAlternatePaths <PSListModifier>] [-BypassID <String>] [-CentralSite <String>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-VideoAlternatePath <$true | $false>] [-WhatIf [<SwitchParameter>]]

Set-CsNetworkRegion [-AudioAlternatePath <$true | $false>] [-BWAlternatePaths <PSListModifier>] [-BypassID <String>] [-CentralSite <String>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-VideoAlternatePath <$true | $false>] [-WhatIf [<SwitchParameter>]]

Descrição Detalhada

Uma região de rede interconecta diversas partes de uma rede em diversas áreas geográficas. Toda região de rede deve ser associada a um site central. O site central é o site do data center no qual estiver em execução o serviço de política de largura de banda do controle de admissão de chamadas (CAC). Utilize esse cmdlet para modificar uma região de rede existente, inclusive definições que determinam se são permitidos caminhos alternativos para as conexões de áudio e vídeo, e associar esses sites à região com uma configuração de desvio de mídia.

Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet Set-CsNetworkRegion 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 "Set-CsNetworkRegion\b"}

Parâmetros

Parâmetro Obrigatório Digite Descrição

Identity

Opcional

XdsGlobalRelativeIdentity

O identificador exclusivo da região de rede que se deseja modificar. A identidade terá o formato de uma cadeia de caracteres que identifica a região de forma exclusiva.

Instance

Opcional

PSObject

Uma referência a um objeto de região de rede. Este objeto deve ser do tipo Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.NetworkRegionType e pode ser recuperado chamando-se Get-CsNetworkRegion.

AudioAlternatePath

Opcional

Booleano

Esse parâmetro determina se as chamadas de áudio serão roteadas por um caminho alternativo, caso não haja largura de banda adequada no caminho primário.

Esse parâmetro preenche a propriedade BWAlternatePaths. O valor fornecido para esse parâmetro é armazenado na propriedade AlternatePath do elemento de caminho alternativo com o valor BWPolicyModality de Áudio.

Caso seja fornecido um valor para esse parâmetro, não será possível especificar um valor para o parâmetro BWAlternatePaths.

Se qualquer uma das suas chamadas for uma chamada pela Internet, esse valor deve ser True, independentemente das configurações de largura de banda.

BWAlternatePaths

Opcional

PSListModifier

Uma lista de objetos que contêm informações sobre quais caminhos de conexão alternativa são permitidos, caso não haja possibilidade de efetuar uma solicitação de mídia no caminho preferido (por exemplo, se os limites nesse caminho tiverem sido excedidos). Os objetos de caminho alternativo devem ser do tipo Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.BWAlternatePathType. É possível criar objetos desse tipo chamando-se o cmdlet New-CsNetworkBWAlternatePath.

BypassID

Opcional

Cadeia de caracteres

Um identificador global exclusivo (GUID). Este GUID é utilizado para mapear regiões de rede para as definições de desvio de mídia em uma configuração de rede do CAC ou Enhanced 9-1-1 (E9-1-1). (utilize este valor de BypassID ao chamar New-CsNetworkMediaBypassConfiguration).

Esse parâmetro pode ser gerado automaticamente quando a região for criada (chamando-se o cmdlet New-CsNetworkRegion). Não é recomendável alterar esse valor. Caso especifique um valor, faça-o no formato de um GUID (por exemplo: 3b24a047-dce6-48b2-9f20-9fbff17ed62a). Será emitida uma confirmação, solicitando a confirmação da intenção de se definir manualmente esse valor.

CentralSite

Opcional

Cadeia de caracteres

O site central que executa o serviço de política de largura de banda. Esse serviço deve ser habilitado para usar o CAC. Esse serviço é executado no Servidor Front-End ou no Servidor Standard Edition.

Description

Opcional

Cadeia de caracteres

Uma cadeia de caracteres que descreve a região. Este parâmetro pode ser utilizado para fornecer uma explicação mais descritiva sobre a função da região, superando o que pode ser expresso apenas pela identidade.

VideoAlternatePath

Opcional

Booleano

Esse parâmetro determina se as chamadas de vídeo serão roteadas por um caminho alternativo, caso não haja largura de banda adequada no caminho primário.

Esse parâmetro preenche a propriedade BWAlternatePaths. O valor fornecido para esse parâmetro é armazenado na propriedade AlternatePath do elemento de caminho alternativo com o valor BWPolicyModality de Vídeo.

Caso seja fornecido um valor para esse parâmetro, não será possível especificar um valor para o parâmetro BWAlternatePaths.

Se qualquer uma das suas chamadas for uma chamada pela Internet, esse valor deve ser True, independentemente das configurações de largura de banda.

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.NetworkRegionType. Aceita entradas canalizadas dos objetos 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.NetworkRegionType.

Exemplo

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

Set-CsNetworkRegion -Identity NorthAmerica -Description "North American Region"

Neste exemplo, modifica-se a região de rede denominada Vancouver. O parâmetro Description recebe o valor "Região norte-americana". Se existir uma Descrição na região NorthAmerica, esse comando a substituirá por esse valor. Se nenhuma Descrição tiver sido definida, esse comando a definirá.

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

Set-CsNetworkRegion -Identity EMEA -VideoAlternatePath $False

Esse exemplo modifica a região de rede chamada EMEA e fornecerá a ela uma nova definição de caminho alternativo de vídeo. Para isso, chamamos Set-CsNetworkRegion passando-lhe a Identidade EMEA. Em seguida, especificamos o parâmetro VideoAlternatePath, passando-lhe o valor $False. A definição de VideoAlternatePath como False indica que, se não houver disponibilidade de largura de banda adequada, a chamada de vídeo não será roteada para um caminho alternativo. Em vez disso, ela simplesmente não será efetuada.

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

$a = Get-CsNetworkRegion -Identity NorthAmerica
$a.BWAlternatePaths | foreach {Set-CsNetworkRegion -Identity Asia -BWAlternatePaths @{add=$_}}

O Exemplo 3 atribui à região de rede Asia o mesmo conjunto de definições de caminho alternativo que tiver sido atribuído à região NorthAmerica. A primeira linha nesse exemplo recupera uma instância da região de rede NorthAmerica e a atribui à variávlel $a. A segunda linha inicialmente recupera o conteúdo da propriedade BWAlternatePaths ou da região NorthAmerica (armazenada na variável $a): $a.BWAlternatePaths. Essa será uma coleção de todas as definições de caminho alternativo na região NorthAmerica.

A próxima ação consiste em canalizar essa coleção de definições para a função foreach. Foreach lidará com um item da coleção por vez, realizando as ações nas seguintes chaves. Nesse caso, a ação consiste em chamar Set-CsNetworkRegion com uma Identidade de Asia, para definir as propriedades da região Asia. O próximo parâmetro é BWAlternatePaths. Passamos o valor @{add=$_} para esse parâmetro. A variável $_ representa o item atual na coleção, nesse caso, o caminho alternativo atual. A porção @{add=} do valor adiciona esse item à coleção BWAlternatePaths da região Asia.