Remove-CsLisPort
Tópico modificado em: 2012-03-27
Remove uma associação entre uma porta LIS e um local. A associação é usada na implementação de um Enhanced 9 (E9-1-1) Enterprise Voice para notificar um operador de serviços de emergência quanto ao local do chamador.
Sintaxe
Remove-CsLisPort -ChassisID <String> -PortID <String> -PortIDSubType <InterfaceAlias | InterfaceName | LocallyAssigned> [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]]
Descrição Detalhada
O Enhanced 9-1-1 permite que um operador de emergência identifique o local de um chamador sem ter de pedir essa informação ao chamador. 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 uma associação entre um local físico e uma porta pela qual as ligações serão roteadas, removendo a porta do banco de dados de configuração de locais.
A remoção de um local de porta não removerá o local real da porta, mas apenas a porta. Para remover o local, chame o cmdlet Remove-CsLisLocation. A remoção da porta também não removerá o comutador com o ChassisID determinado; para remover o comutador, chame o cmdlet Remove-CsLisSwitch.
Se você tentar remover uma porta 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-CsLisPort localmente: RTCUniversalServerAdmins. Para retornar uma lista de todas as funções de controle de acesso baseado em função (RBAC) às quais este cmdlet foi atribuído (inclusive qualquer função RBAC personalizada que tenha sido criada por você), execute o seguinte comando no prompt do Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsLisPort"}
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 da porta. Esse valor estará no formato nn-nn-nn-nn-nn-nn (como 12-34-56-78-90-ab, por exemplo). |
PortID |
Obrigatório |
Cadeia de caracteres |
O ID da porta que você deseja remover. |
PortIDSubType |
Obrigatório |
PortIDSubType |
O subtipo da porta que você deseja remover. Este valor pode ser inserido como um valor numérico ou uma cadeia de caracteres, mas deve ser um subtipo válido. Os subtipos válidos são: 1: InterfaceAlias 5: InterfaceName 7: LocallyAssigned |
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 porta 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-CsLisPort -ChassisID 99-99-99-99-99-99 -PortID 4200 -PortIDSubType 1
O Exemplo 1 remove a porta LIS com o endereço MAC (ChassisID) 99-99-99-99-99-99, o PortID 4200 e o PortIDSubType 1 (observe que PortIDSubType com o valor 1 é convertido em um valor InterfaceAlias). Este parâmetro e este valor também podem ser inseridos da seguinte maneira: -PortIDSubType InterfaceAlias)
Se esta porta estiver associada a um local, este não será removido, mas apenas a porta será removida do mapeamento de locais.
-------------------------- Exemplo 2 --------------------------
Get-CsLisPort | Where-Object {$_.HouseNumber -eq ""} | Remove-CsLisPort
Esse exemplo remove todos os locais de porta que não possuírem um número de residência. O exemplo começa com a chamada ao cmdlet Get-CsLisPort, que retorna uma coleção de todas as portas LIS. Essa coleção será canalizada para o cmdlet Where-Object, que localizará os itens nessa coleção que possuírem a propriedade HouseNumber vazia (em outras palavras, HouseNumber igual a [-eq] uma cadeia de caracteres vazia [“”]). Finalmente, canalizaremos essa coleção de locais de porta que não possuem números de residências para o cmdlet Remove-CsLisPort, que removerá tudo nessa coleção.
Observe que, como no exemplo 1, nenhum local será removido do banco de dados de local, mas apenas as portas que fizerem referência a esses locais. Nesse caso, isso significa que haverá locais inválidos (porque HouseNumber é 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.