Remove-CsLisSwitch
Tópico modificado em: 2012-03-27
Remove um comutador de rede LIS (Servidor de Informações de Local).
Sintaxe
Remove-CsLisSwitch -ChassisID <String> [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]]
Descrição Detalhada
Enhanced 9-1-1 (E9-1-1) permite que um operador de emergência identifique o local de um chamador sem ter de lhe solicitar essa informação. Caso o chamador esteja chamando de uma conexão VoIP, essa informação deve ser extraída com base em diversos fatores de conexão. O administrador VoIP deve configurar um mapa de local (denominado wiremap) que determinará o local de um chamador. Esse cmdlet remove um comutador do banco de dados de configuração de locais. A remoção de um comutador não removerá o local real, mas apenas o comutador. Para remover o local, chame o cmdlet Remove-CsLisLocation.
Não é possível remover um comutador se o ChassisID do comutador estiver sendo usado por uma porta. (execute o seguinte comando para localizar quais ChassisIDs estão sendo usados pelas portas: Get-CsLisPort | Select-Object ChassisID.) É necessário primeiramente remover todas as portas com o ChassisID antes de remover o comutador.
Se você tentar remover um comutador que não existe, nenhuma ação será tomada e não será exibido qualquer erro ou mensagem de aviso.
Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet Remove-CsLisSwitch 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-CsLisSwitch"}
Parâmetros
| Parâmetro | Obrigatório | Digite | Descrição |
|---|---|---|---|
ChassisID |
Obrigatório |
Cadeia de caracteres |
O endereço MAC (Controle de Acesso de Mídia) do comutador de rede. Esse valor estará no formato nn-nn-nn-nn-nn-nn (como 12-34-56-78-90-ab, por exemplo). |
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
Aceita entradas canalizadas de objetos de comutador de LIS.
Tipos de Retorno
Este cmdlet não retorna um valor. Remove um objeto do tipo System.Management.Automation.PSCustomObject.
Exemplo
-------------------------- Exemplo 1 --------------------------
Remove-CsLisSwitch -ChassisID 99-99-99-99-99-99
O Exemplo 1 remove o comutador LIS com o endereço MAC (ChassisID) 99-99-99-99-99-99.
Esse comando não será executado se uma porta fizer referência ao ChassisID. Além disso, se o comutador estiver associado a um local, esse local não será removido, mas o comutador será simplesmente removido do mapeamento de local.
-------------------------- Exemplo 2 --------------------------
Get-CsLisSwitch | Where-Object {$_.City -eq ""} | Remove-CsLisSwitch
Esse exemplo remove todos os comutadores que não possuírem uma cidade. O exemplo começa com a chamada do cmdlet Get-CsLisSwitch, que retorna uma coleção de todos os comutadores. Essa coleção será canalizada para o cmdlet Where-Object, que localiza os itens nessa coleção cuja propriedade City estiver vazia; em outras palavras, uma Cidade que seja igual a (-eq) uma cadeia de caracteres vazia (“”). Finalmente, canalizaremos essa coleção de comutadores que não possuem cidades para o cmdlet Remove-CsLisSwitch, que removerá tudo nessa coleção.
Observe que, como no Exemplo 1, nenhum local será removido do banco de dados de locais, mas apenas os comutadores que fizerem referência a esses locais serão removidos. Nesse caso, isso significa que haverá locais inválidos (eles são inválidos porque Cidade é uma propriedade necessária a um local) no banco de dados de locais que também deverá ser removido. É possível remover os locais, chamando-se o cmdlet Remove-CsLisLocation.