Compartilhar via

  • Artigo

Remove-CsNetworkRegionLink

 

Tópico modificado em: 2012-03-26

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

Sintaxe

Remove-CsNetworkRegionLink -Identity <XdsGlobalRelativeIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Descrição Detalhada

As regiões dentro de uma rede são vinculadas por meio da conectividade Wan. Esse cmdlet não afeta qualquer conexão física, mas remove o link da configuração de CAC.

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

Parâmetros

Parâmetro Obrigatório Digite Descrição

Identity

Obrigatório

XdsGlobalRelativeIdentity

O identificador exclusivo do link da região de rede que se deseja remover. Como os links de região de rede são criados apenas no escopo global, esse identificador não precisa especificar um escopo. Em vez disto, ele contém uma cadeia de caracteres que é um nome exclusivo que identifica este link.

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.NetworkRegionLinkType. Aceita entrada canalizada dos objetos de link de região de rede.

Tipos de Retorno

Este cmdlet não retorna um valor. Ele remove um objeto do tipo Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.NetworkRegionLinkType.

Exemplo

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

Remove-CsNetworkRegionLink -Identity NA_EMEA

Esse primeiro exemplo remove um link de região de rede cuja identidade for NA_EMEA.

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

Get-CsNetworkRegionLink | Where-Object {$_.BWPolicyProfileID -eq "HighBWLimits"} | Remove-CsNetworkRegionLink

O Exemplo 2 remove todos os links de região de rede que estiverem utilizando o perfil da política de largura de banda denominado HighBWLimits. O primeiro cmdlet chamado no exemplo é Get-CsNetworkRegionLink, sem parâmetros, o que recupera todos os links de região. Esta coleção de links será então canalizada para o cmdlet Where-Object. Where-Object examina cada membro da coleção, verificando o valor da propriedade BWPolicyProfileID. Se essa propriedade for igual a (-eq) HighBWLimits, canalizaremos esse membro para o cmdlet Remove-CsNetworkRegionLink, que removerá o link.