Compartilhar via


New-CsNetworkInterSitePolicy

 

Tópico modificado em: 2012-03-27

Cria uma nova política entre sites de rede que define as limitações de largura de banda entre sites que estiverem diretamente ligados em uma configuração do controle de admissão de chamadas (CAC).

Sintaxe

New-CsNetworkInterSitePolicy -Identity <XdsGlobalRelativeIdentity> -NetworkSiteID1 <String> -NetworkSiteID2 <String> [-BWPolicyProfileID <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

New-CsNetworkInterSitePolicy -InterNetworkSitePolicyID <String> -NetworkSiteID1 <String> -NetworkSiteID2 <String> [-BWPolicyProfileID <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Descrição Detalhada

Quando os sites de uma rede compartilham um link direto, é possível definir limitações de largura de banda às conexões de áudio e vídeo entre esses dois sites. Este cmdlet cria uma política de site de rede, que associa uma política de limitação de largura de banda a dois sites conectados diretamente.

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

Parâmetros

Parâmetro Obrigatório Digite Descrição

Identity

Obrigatório

XdsGlobalRelativeIdentity

Um identificador exclusivo da política entre sites de rede recém-criada. As políticas entre sites de rede são criadas apenas no escopo global, de forma que não é necessário que esse identificador especifique um escopo. Em vez disso, ele contém uma cadeia de caracteres que é um nome exclusivo que identifica a política do site.

InterNetworkSitePolicyID

Obrigatório

Cadeia de caracteres

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

NetworkSiteID1

Obrigatório

Cadeia de caracteres

A Identidade (NetworkSiteID) de um dos dois sites associados a essa política. A combinação de NetworkSiteID1 e NetworkSiteID2 deve ser exclusiva (por exemplo, não é possível que haja duas políticas de site definidas que conectem Reno e Portland).

NetworkSiteID2

Obrigatório

Cadeia de caracteres

A Identidade (NetworkSiteID) de um dos dois sites associados a essa política. A combinação de NetworkSiteID1 e NetworkSiteID2 deve ser exclusiva (por exemplo, não é possível que haja duas políticas de site definidas que conectem Reno e Portland).

BWPolicyProfileID

Opcional

Cadeia de caracteres

A identidade do perfil de política de largura de banda que definirá as limitações a esta política de site. É possível recuperar uma lista de perfis disponíveis, chamando-se o cmdlet Get-CsNetworkBandwidthPolicyProfile.

Force

Opcional

SwitchParameter

Suprime qualquer aviso de confirmação que, de outra maneira, seria exibido antes de se 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.InterNetworkSitePolicyType.

Exemplo

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

New-CsNetworkInterSitePolicy -Identity Reno_Portland -NetworkSiteID1 Reno -NetworkSiteID2 Portland -BWPolicyProfileID LowBWLimits

Esse exemplo cria uma nova política entre sites de rede que limita a largura de banda entre os sites conectados de Reno e Portland. As limitações de largura de banda às conexões de áudio e vídeo entre esses sites se darão com base na definição configurada para o perfil de política de largura de banda LowBWLimits.