Remove-CsNetworkRegion
Tópico modificado em: 2012-03-25
Remove uma região de rede existente. As regiões de rede representam hubs de rede ou backbones em uma rede corporativa.
Sintaxe
Remove-CsNetworkRegion -Identity <XdsGlobalRelativeIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-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 o serviço de política de largura de banda estiver em execução. Utilize este cmdlet para remover uma região de rede.
Observe que uma região de rede não pode ser removida se estiver associada a um site de rede (em outras palavras, NetworkRegionID de qualquer site é igual à identidade da região). Se você tentar remover uma região associada a um site, receberá uma mensagem de erro.
Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet Remove-CsNetworkRegion localmente: RTCUniversalServerAdmins. Para retornar uma lista de todas as funções do controle de acesso baseado em função (RBAC) que receberam a atribuição desse cmdlet (incluindo qualquer função RBAC personalizada criada por você), execute o seguinte comando do prompt Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsNetworkRegion"}
Parâmetros
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
Identity |
Obrigatório |
XdsGlobalRelativeIdentity |
O identificador exclusivo da região de rede que se deseja remover. A identidade terá o formato de uma cadeia de caracteres que identifica a região de forma exclusiva. |
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 entrada em pipeline dos objetos 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.NetworkRegionType.
Exemplo
-------------------------- Exemplo 1 --------------------------
Remove-CsNetworkRegion -Identity NorthAmerica
O Exemplo 1 remove a região de rede cuja identidade for NorthAmerica. Como as identidades são exclusivas, esse comando remove apenas uma região de rede.
-------------------------- Exemplo 2 --------------------------
Get-CsNetworkRegion | Where-Object {$_.CentralSite -eq "site:Redmond"} | Remove-CsNetworkRegion
Este exemplo remove todas as regiões de rede associadas ao site central Redmond. O comando inicialmente chama o cmdlet Get-CsNetworkRegion sem parâmetros para recuperar uma coleção de todas as regiões de rede definidas para a implantação do Microsoft Lync Server 2010. Esta coleção é então canalizada para o cmdlet Where-Object. Where-Object filtra essa coleção retornando apenas os itens (regiões de rede) cujo valor CentralSite for igual a (-eq) site:Redmond. Depois que a coleção tiver sido restrita a estes itens, essa nova coleção será canalizada para Remove-CsNetworkRegion, que removerá cada item na coleção.
-------------------------- Exemplo 3 --------------------------
Get-CsNetworkSite | Where-Object {$_.NetworkRegionID -eq "NorthAmerica"} | Set-CsNetworkSite -NetworkRegionID $null -BypassID $null
Remove-CsNetworkRegion -Identity "NorthAmerica"
Esse exemplo remove a região de rede cuja identidade for NorthAmerica. Entretanto, uma região não pode ser removida se estiver associada a um site. Portanto, este exemplo remove primeiramente qualquer associação entre a região NorthAmerica e um site.
O exemplo inicialmente chama o cmdlet Get-CsNetworkSite sem parâmetros recuperando uma coleção de todos os sites de rede definidos para a implantação do Lync Server. Esta coleção é então canalizada para o cmdlet Where-Object. Where-Object filtra essa coleção retornando apenas os itens (sites de rede) cujo valor NetworkRegionID for igual a (-eq) NorthAmerica. Depois que a coleção tiver sido restrita a estes itens, esta nova coleção será canalizada para Set-CsNetworkSite. Para cada site contendo o NetworkRegionID NorthAmerica, define-se o NetworkRegionID como sendo Null. Isto remove a referência à região neste site. Entretanto, um site não pode ter um ID de desvio se não estiver associado a um site. Portanto, além de remover a referência à região definindo o NetworkRegionID como Null, deve-se remover também a associação de desvio, definindo BypassID como Null.
Depois que a linha 1 tiver sido concluída, qualquer site que tiver sido associado à região NorthAmerica deixará de ser vinculado à região ou a quaisquer definições de desvio. Neste ponto, é possível chamar a linha 2, que removerá a região de rede.