Compartilhar via

  • Artigo

Set-CsNetworkConfiguration

 

Tópico modificado em: 2012-03-27

Modifica as definições de uma configuração de rede. Na maioria das vezes, esse cmdlet será usado para habilitar ou desabilitar o controle de admissão de chamadas (CAC).

Sintaxe

Set-CsNetworkConfiguration [-Identity <XdsIdentity>] [-BWPolicyProfiles <PSListModifier>] [-Confirm [<SwitchParameter>]] [-EnableBandwidthPolicyCheck <$true | $false>] [-Force <SwitchParameter>] [-InterNetworkRegionRoutes <PSListModifier>] [-InterNetworkSitePolicies <PSListModifier>] [-MediaBypassSettings <MediaBypassSettingsType>] [-NetworkRegionLinks <PSListModifier>] [-NetworkRegions <PSListModifier>] [-NetworkSites <PSListModifier>] [-Subnets <PSListModifier>] [-WhatIf [<SwitchParameter>]]

Set-CsNetworkConfiguration [-BWPolicyProfiles <PSListModifier>] [-Confirm [<SwitchParameter>]] [-EnableBandwidthPolicyCheck <$true | $false>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-InterNetworkRegionRoutes <PSListModifier>] [-InterNetworkSitePolicies <PSListModifier>] [-MediaBypassSettings <MediaBypassSettingsType>] [-NetworkRegionLinks <PSListModifier>] [-NetworkRegions <PSListModifier>] [-NetworkSites <PSListModifier>] [-Subnets <PSListModifier>] [-WhatIf [<SwitchParameter>]]

Descrição Detalhada

O objeto de configuração de rede contém todas as definições de uma configuração de CAC completa da implantação de um Microsoft Lync Server 2010, além das definições de desvio de mídia. É possível usar esse cmdlet para modificar qualquer parte da configuração de CAC e é necessário usá-lo se precisar alterar as definições de desvio de mídia. No entanto, ao se modificar a maioria das definições de configuração de CAC, é recomendável utilizar os cmdlets específicos ao tipo de objeto. Por exemplo, para trabalhar com regiões de rede, utilize os cmdlets que terminam com CsNetworkRegion, em vez de manipular o parâmetro NetworkRegions desse cmdlet.

O uso principal desse cmdlet é habilitar (e desabilitar) o CAC e aplicar as definições de desvio de mídia. Depois de definir os diversos componentes necessários à configuração (regiões, sites e sub-redes), será necessário habilitar a configuração, para que ela funcione. Para fazê-lo, simplesmente defina o parâmetro EnableBandwidthPolicyCheck como sendo True. Observe que a execução desse cmdlet com EnableBandwidthPolicyCheck definido como True não habilitará imediatamente o CAC. Antes que ele possa ser habilitado, é feita uma série de verificações de validação, para garantir que a instalação tenha sido configurada adequadamente. Qualquer erro ou discrepância na instalação exibirá avisos e perguntará se você deseja continuar a habilitar o CAC, mesmo que haja um problema. Se você preferir continuar (pressionando Enter ou Y), a validação continuará e perguntará novamente caso seja relatado outro problema.

Se você executar toda a validação, optando por continuar após cada aviso, EnableBandwidthPolicyCheck será definido como True e o CAC será habilitado, mas enquanto os problemas não forem solucionados, ele provavelmente não funcionará como esperado. Se, em algum momento da validação, você optar por interrompê-la (digitando N no prompt de aviso), ela será encerrada e EnableBandwidthPolicyCheck permanecerá definido como False (o padrão).

Se EnableBandwidthPolicyCheck já estiver definido como True, será possível chamar Set-CsNetworkConfiguration e passar o valor True para o parâmetro EnableBandwidthPolicyCheck, para executar a validação sem modificar qualquer definição. Além disso, quando EnableBandwidthPolicyCheck for True, todas as alterações que se tentar realizar chamando-se Set-CsNetworkConfiguration causarão nova execução da verificação de validação.

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

Parâmetros

Parâmetro Obrigatório Digite Descrição

Identity

Opcional

XdsIdentity

Esse valor sempre será Global.

Instance

Opcional

NetworkConfigurationSettings

Uma referência a um objeto de configuração de rede. Este objeto deve ser do tipo Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.NetworkConfigurationSettings, que pode ser recuperado chamando-se o cmdlet Get-CsNetworkConfiguration.

BWPolicyProfiles

Opcional

PSListModifier

Uma coleção de todos os perfis de política de largura de banda que podem ser atribuídas a sites, políticas entre sites e links de região de rede. Cada perfil de política de largura de banda contém limitações de largura de banda (limitações gerais e de sessão) às conexões de áudio e/ou vídeo. É possível recuperar uma lista completa de perfis de política de largura de banda, chamando-se o cmdlet Get-CsNetworkBandwidthPolicyProfile.

EnableBandwidthPolicyCheck

Opcional

Booleano

A definição desse parâmetro como True executará uma verificação de validação em toda a configuração do CAC. Se as verificações de validação forem aprovadas ou se você optar por ignorar todos os avisos, o CAC será habilitado. Se uma verificação de validação não for aprovada, você poderá optar por interromper a validação e o valor de EnableBandwidthPolicyCheck não será alterado.

A definição desse valor como False desabilitará o CAC.

Padrão: False

InterNetworkRegionRoutes

Opcional

PSListModifier

Uma coleção de todas as rotas de região de rede definidas na configuração do CAC. É possível recuperar todos os membros dessa coleção, chamando-se o cmdlet Get-CsNetworkInterRegionRoute.

InterNetworkSitePolicies

Opcional

PSListModifier

Uma coleção de políticas entre sites de rede, definidas na configuração do CAC. É possível recuperar todos os membros dessa coleção, chamando-se o cmdlet Get-CsNetworkInterSitePolicy.

MediaBypassSettings

Opcional

MediaBypassSettingsType

Uma referência a um objeto que estabelece as definições globais de desvio de mídia da configuração do CAC. A definição desse valor substituirá todas as definições de desvio de mídia existentes. Essa referência de objeto é obtida chamando-se o cmdlet New-CsNetworkMediaBypassConfiguration e atribuindo-se as novas definições de configuração a uma variável. Passe essa variável para o parâmetro MediaBypassSettings, para alterar as definições globais de desvio de mídia.

NetworkRegionLinks

Opcional

PSListModifier

Uma coleção de todos os links de região de rede, definidos na configuração do CAC. Cada link de região de rede define uma conexão existente entre duas regiões e qualquer limitação de largura de banda que deva ser aplicada a conexões entre essas regiões. É possível recuperar todos os membros dessa coleção, chamando-se o cmdlet Get-CsNetworkRegionLink.

NetworkRegions

Opcional

PSListModifier

Uma coleção de regiões de rede (cada uma representando um hub ou backbone dentro da rede), definidas na configuração do CAC. É possível recuperar todos os membros dessa coleção, chamando-se o cmdlet Get-CsNetworkRegion.

NetworkSites

Opcional

PSListModifier

Uma coleção de locais de rede (cada um representando um escritório ou local de uma região), definidos na configuração do CAC. É possível recuperar todos os membros dessa coleção, chamando-se o cmdlet Get-CsNetworkSite.

Subnets

Opcional

PSListModifier

Uma coleção de sub-redes da rede (cada qual associa um ponto de extremidade a um site) definidas na configuração do CAC. É possível recuperar todos os membros dessa coleção, chamando-se o cmdlet Get-CsNetworkSubnet.

Force

Opcional

SwitchParameter

Este parâmetro não aceita qualquer valor. Se você incluir esse parâmetro, todas as alterações feitas na configuração, inclusive a sua habilitação, entrarão em vigor sem avisos ou verificações de validação.

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.NetworkConfigurationSettings. Aceita entrada canalizada de um objeto de configuração de rede.

Tipos de Retorno

Set-CsNetworkConfiguration não retorna um valor ou objeto. Em vez disso, o cmdlet modifica instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.NetworkConfigurationSettings.

Exemplo

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

Set-CsNetworkConfiguration -EnableBandwidthPolicyCheck $True

O comando desse exemplo executará uma verificação de validação em toda a configuração do CAC e, em seguida (dependendo de suas respostas a todos os prompts de aviso que forem retornados), habilitará o CAC. Se o CAC já estiver habilitado (em outras palavras, se a propriedade EnableBandwidthPolicyCheck for True) e você executar esse comando, ele simplesmente executará a verificação de validação.