Compartilhar via

  • Artigo

New-CsNetworkRegion

 

Tópico modificado em: 2012-03-26

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

Sintaxe

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

New-CsNetworkRegion -CentralSite <String> -NetworkRegionID <String> [-AudioAlternatePath <$true | $false>] [-BWAlternatePaths <PSListModifier>] [-BypassID <String>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-VideoAlternatePath <$true | $false>] [-WhatIf [<SwitchParameter>]]

Descrição Detalhada

Uma região de rede interconecta várias partes de uma rede em múltiplas áreas geográficas. Cada região de rede deve ser associada a um site central. O site central é o site de data center no qual o serviço de diretiva de largura de banda do CAC (controle de admissão de chamadas) está em execução. Use este cmdlet para criar uma nova região de rede. Com os parâmetros deste cmdlet, é possível oferecer configurações que determinam se caminhos alternativos pela Internet são permitidos para conexões de áudio e vídeo e se podem gerar automaticamente o ID de passagem livre (bypass ID).

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

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Obrigatório

XdsGlobalRelativeIdentity

Um identificador exclusivo para a região de rede recém-criada. As regiões 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 região.

CentralSite

Obrigatório

Cadeia de caracteres

O site central executando o serviço de diretiva de largura de banda. Este serviço precisa ser habilitado para que o CAC seja usado. Ele é executado no Servidor Front-End ou no Servidor Standard Edition.

NetworkRegionID

Obrigatório

Cadeia de caracteres

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

AudioAlternatePath

Opcional

Booleano

Este parâmetro determina se chamadas de áudio serão encaminhadas por um caminho alternativo, se não houver largura de banda adequada no caminho principal.

Este parâmetro popula a propriedade BWAlternatePaths. O valor fornecido para este parâmetro é armazenado na propriedade AlternatePath para o elemento de caminho alternativo com valor de BWPolicyModality igual a Audio.

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

Padrão: True. Defina o parâmetro como False apenas se precisar desativar a descarga para a Internet. Se qualquer uma das suas chamadas for chamadas da Internet, este valor deverá ser True, independentemente das configurações de largura de banda.

BWAlternatePaths

Opcional

PSListModifier

Uma lista de objetos que contêm informações que definem se caminhos de conexão alternativos à Internet serão permitidos se uma solicitação de mídia não puder ser concluída pelo caminho preferido (por exemplo, se os limites desse caminho tiverem sido excedidos). Objetos de caminho alternativo precisam ser criados com o cmdlet New-CsNetworkBWAlternatePath.

Se um valor for fornecido para o parâmetro, não será possível fornecer valores para os parâmetros AudioAlternatePath ou VideoAlternatePath.

Os caminhos alternativos para áudio e vídeo estão habilitados (AlternatePath = True) por padrão.

BypassID

Opcional

Cadeia de caracteres

Um identificador global exclusivo (GUID). Este GUID é usado para mapear regiões de rede a configurações de passagem livre de mídia em uma configuração de rede de CAC ou Enhanced 9-1-1 (E9-1-1) (use este valor de BypassID na chamada a New-CsNetworkMediaBypassConfiguration).

Se um valor não for especificado para este parâmetro, um valor será gerado automaticamente. Caso especifique um valor, faça-o no formato de um GUID (por exemplo, 3b24a047-dce6-48b2-9f20-9fbff17ed62a). A geração automática é recomendável. Caso especifique um valor para este parâmetro, você receberá uma solicitação de confirmação perguntando se realmente deseja fornecer o valor em vez de permitir que seja gerado automaticamente.

Description

Opcional

Cadeia de caracteres

Uma cadeia de caracteres que descreve a região. O parâmetro pode ser usado para fornecer uma explicação mais descritiva sobre a região do que a Identity é capaz de expressar.

VideoAlternatePath

Opcional

Booleano

Este parâmetro determina se chamadas de vídeo serão encaminhadas por um caminho alternativo, se não houver largura de banda adequada no caminho principal.

Este parâmetro popula a propriedade BWAlternatePaths. O valor fornecido para este parâmetro é armazenado na propriedade AlternatePath para o elemento de caminho alternativo com valor de BWPolicyModality igual a Video.

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

Padrão: True. Defina o parâmetro como False apenas se precisar desativar a descarga para a Internet. Se qualquer uma das suas chamadas for chamadas da Internet, este valor deverá ser True, independentemente das configurações de largura de banda.

Force

Opcional

SwitchParameter

Suprime eventuais avisos de confirmação que seriam exibidos antes da realização das alterações. Por exemplo, se você fornecer um valor para o parâmetro BypassID, sua confirmação não será solicitada.

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.NetworkRegionType.

Exemplo

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

New-CsNetworkRegion -Identity NorthAmerica -Description "All North American Locations" -CentralSite Redmond-NA-MLS

Neste exemplo, uma nova região de rede chamada NorthAmerica é criada. O nome da região é especificado como o valor do parâmetro Identity. Um valor também é especificado para o parâmetro opcional Description, descrevendo essa região como sendo "All North American Locations" (todos os locais da América do Norte). Por fim, o parâmetro CentralSite recebe um valor do nome do site central dessa região, Redmond-NA-MLS.

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

New-CsNetworkRegion -Identity EMEA -CentralSite Dublin-EU-Site -AudioAlternatePath $False

Este exemplo cria uma nova região de rede chamada EMEA que inclui configurações para um caminho alternativo de áudio. Para fazer isso, chamamos New-CsNetworkRegion passando a Identidade EMEA. Atribuímos um valor ao parâmetro exigido CentralSite (no exemplo, o nome do site central da região é Dublin-EU-Site), e em seguida especificamos o parâmetro AudioAlternatePath, passando a ele o valor $False. Definir AudioAlternatePath como False indica que, se não houver largura de banda adequada disponível, as chamadas de áudio não serão roteadas para um caminho alternativo: elas simplesmente não serão concluídas.

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

$a = New-CsNetworkBWAlternatePath -BWPolicyModality "audio" -AlternatePath $False
New-CsNetworkRegion -Identity EMEA -CentralSite Dublin-EU-Site -BWAlternatePaths $a

Este exemplo cria a mesma região de rede que foi criada no Exemplo 2. Porém, nesse caso, usamos o parâmetro BWAlternatePaths para definir as configurações de caminho alternativo em vez do parâmetro AudioAlternatePath. A primeira linha do exemplo chama o cmdlet New-CsNetworkBWAlternatePath para criar um novo caminho alternativo. Um caminho alternativo só tem duas propriedades. BWPolicyModality, que deve ser definido como audio ou video (no caso, audio); e AlternatePath, que deve ser definido como True ou False (no caso, False). Atribuímos a saída do cmdlet, uma referência ao objeto de caminho alternativo recém-criado, à variável $a.

Na linha 2 do exemplo, usamos este caminho alternativo recém-criado ao criarmos uma nova região de rede. Para fazer isso, chamamos New-CsNetworkRegion passando a Identidade EMEA. Atribuímos um valor ao parâmetro exigido CentralSite (no exemplo, o nome do site central da região é Dublin-EU-Site), e em seguida especificamos o parâmetro BWAlternatePaths, passando a ele a variável ($a) que contém o objeto de caminho alternativo que acabamos de criar.