Set-CsLisPort
Tópico modificado em: 2012-03-26
Cria uma porta de LIS (servidor de informações de local), cria uma associação entre uma porta e um local (criando um novo local, caso o local não exista) ou modifica uma porta existente e seu local associado. A associação entre uma porta e um local é usada em uma implementação do Enhanced 9-1-1 (E9-1-1) Enterprise Voice para notificar a localização do chamador ao operador de serviços de emergência.
Sintaxe
Set-CsLisPort -ChassisID <String> -PortID <String> [-City <String>] [-CompanyName <String>] [-Confirm [<SwitchParameter>]] [-Country <String>] [-Description <String>] [-HouseNumber <String>] [-HouseNumberSuffix <String>] [-Location <String>] [-PortIDSubType <InterfaceAlias | InterfaceName | LocallyAssigned>] [-PostalCode <String>] [-PostDirectional <String>] [-PreDirectional <String>] [-State <String>] [-StreetName <String>] [-StreetSuffix <String>] [-WhatIf [<SwitchParameter>]]
Set-CsLisPort -ChassisID <String> -PortID <String> [-Confirm [<SwitchParameter>]] [-Description <String>] [-PortIDSubType <InterfaceAlias | InterfaceName | LocallyAssigned>] [-WhatIf [<SwitchParameter>]]
Set-CsLisPort -City <String> -CompanyName <String> -Country <String> -HouseNumber <String> -HouseNumberSuffix <String> -Location <String> -PostalCode <String> -PostDirectional <String> -PreDirectional <String> -State <String> -StreetName <String> -StreetSuffix <String> [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]]
Descrição Detalhada
O Enhanced 9-1-1 permite ao operador do serviço de emergência identificar a localização de um chamador sem ter que pedir essa informação a ele. Quando um chamador liga a partir de uma conexão VoIP, essa informação precisa ser extraída com base em vários fatores de conexão. O administrador de VoIP precisa configurar um mapa de locais (ou wiremap) que determinará o local de um chamador. Este cmdlet permite ao administrador mapear locais físicos à porta pela qual o cliente está conectado.
A combinação de ChassisID, PortID e PortIDSubType compõe um local de porta único. Se for digitada uma combinação de chaves ChassisID/PortID/PortIDSubType que já exista, o cmdlet irá atualizar o local da porta com base nos parâmetros de locais fornecidos. Se a combinação de chaves não existir, um novo local de porta será criado.
Se um local com endereço que corresponda exatamente aos parâmetros de endereço inseridos aqui (incluindo valores nulos) não existir no banco de dados de locais, um novo endereço será criado com base nos parâmetros inseridos com este cmdlet. (para recuperar uma lista de locais, chame o cmdlet Get-CsLisLocation). O cmdlet Set-CsLisPort não exige nem solicita parâmetros de locais, e é possível criar uma entrada de porta sem associá-la a um local. Também é possível criar um local inválido com este cmdlet. Um local válido consiste, no mínimo, dos parâmetros Location, HouseNumber, StreetName, City, State e Country. Se todos esses parâmetros não forem fornecidos, chamadas recebidas pela porta referenciada podem não conter as informações exigidas pelo operador do serviço de emergência (dependendo de configurações válidas estarem ou não disponíveis para um comutador, uma sub-rede ou um ponto de acesso sem fio e que possam ser usadas no lugar das configurações de porta). É recomendável que você seja o mais específico possível nos parâmetros de locais, preenchendo tudo o que puder.
Um dos parâmetros exigidos por este cmdlet é ChassisID. ChassisID é o endereço MAC do comutador de rede da porta. Se o comutador não existir no banco de dados de locais, o cmdlet criará esse comutador. Os comutadores existentes podem ser recuperados com o cmdlet Get-CsLisSwitch. Tenha em mente que embora uma nova entrada de comutador seja criada, esse comutador não será associado automaticamente às informações de locais digitadas usando-se o cmdlet Set-CsLisPort; o local do comutador precisa ser definido com o cmdlet Set-CsLisSwitch.
Quem pode executar este cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet Set-CsLisPort localmente: RTCUniversalServerAdmins. Para retornar uma lista de todas as funções do RBAC (controle de acesso baseado na função) atribuídas a este cmdlet (incluindo eventuais funções personalizadas do RBAC que você mesmo tenha criado), execute o comando a seguir no prompt do Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsLisPort"}
Parâmetros
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
ChassisID |
Obrigatório |
Cadeia de caracteres |
O endereço MAC do comutador da porta. O valor deve estar no formato nn-nn-nn-nn-nn-nn, como 12-34-56-78-90-ab, ou como um endereço IP. Se a combinação de ChassisID, PortID e PortIDSubType for única, um novo local de porta será criado. Se a combinação não for única, o local de porta com essa combinação de chaves será atualizado com os valores de parâmetro fornecidos com o comando. |
City |
Obrigatório |
Cadeia de caracteres |
A cidade na qual se localiza a porta. Tamanho máximo: 64 caracteres. |
CompanyName |
Obrigatório |
Cadeia de caracteres |
O nome da empresa nesse local. Tamanho máximo: 60 caracteres |
Country |
Obrigatório |
Cadeia de caracteres |
O país/região no qual a porta se localiza. Tamanho máximo: 2 caracteres |
Description |
Opcional |
Cadeia de caracteres |
Uma descrição detalhada do local desta porta. |
HouseNumber |
Obrigatório |
Cadeia de caracteres |
O número da casa na qual a porta se localiza. Para uma empresa, esse é o número da rua no qual a empresa se localiza. Tamanho máximo: 10 caracteres |
HouseNumberSuffix |
Obrigatório |
Cadeia de caracteres |
Informações adicionais sobre o número da casa, como 1/2 ou A. Por exemplo, 1234 1/2 Oak Street ou 1234 A Elm Street. Observação: Para designar um número de apartamento ou grupo empresarial, use o parâmetro Location. Por exemplo, -Location "Suite 100/Office 150". Tamanho máximo: 5 caracteres |
Location |
Obrigatório |
Cadeia de caracteres |
O nome do local. Geralmente esse valor é o nome de um local mais específico do que o endereço físico, como um número de escritório, mas pode ser qualquer valor de cadeia de caracteres. Tamanho máximo: 20 caracteres |
PortID |
Obrigatório |
Cadeia de caracteres |
O ID da porta associada ao local. |
PortIDSubType |
Opcional |
PortIDSubType |
O subtipo da porta. O valor pode ser digitado como um valor numérico ou uma cadeia de caracteres, mas precisa ser um subtipo válido. Os subtipos válidos são: 1: InterfaceAlias 5: InterfaceName 7: LocallyAssigned Padrão: 7 (LocallyAssigned) |
PostalCode |
Obrigatório |
Cadeia de caracteres |
O CEP associado ao local. Tamanho máximo: 10 caracteres |
PostDirectional |
Obrigatório |
Cadeia de caracteres |
A designação direcional de um nome de rua. Por exemplo, NE ou NW para Main Street NE ou 7th Avenue NW. Tamanho máximo: 2 caracteres |
PreDirectional |
Obrigatório |
Cadeia de caracteres |
A designação direcional para um nome de rua que precede o nome da rua. Por exemplo, NE ou NW para NE Main Street, ou NW 7th Avenue. Tamanho máximo: 2 caracteres |
State |
Obrigatório |
Cadeia de caracteres |
O estado ou província associado a este local. Tamanho máximo: 2 caracteres |
StreetName |
Obrigatório |
Cadeia de caracteres |
O nome da rua nesse local. Tamanho máximo: 60 caracteres |
StreetSuffix |
Obrigatório |
Cadeia de caracteres |
O tipo de rua designado no nome da rua, como Rua, Avenida ou Alameda. Tamanho máximo: 10 caracteres |
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 entrada em pipeline de objetos de porta LIS.
Tipos de Retorno
Este cmdlet cria ou modifica um objeto do tipo System.Management.Automation.PSCustomObject.
Exemplo
-------------------------- Exemplo 1 --------------------------
Set-CsLisPort -ChassisID 99-99-99-99-99-99 -PortID 4200 -PortIDSubType 1
O Exemplo 1 cria ou atualiza uma entrada de local de porta LIS. O comando do exemplo inclui três parâmetros: ChassisID, PortID e PortIDSubtype. O valor de ChassisID é o endereço MAC 99-99-99-99-99-99, o valor de PortID é 4200 e o valor de PortIDSubType é 1 (observe que um valor de 1 para PortIDSubType se traduz em um valor de InterfaceAlias. Este parâmetro e este valor também poderiam ser informados desta maneira: -PortIDSubType InterfaceAlias). Esses três parâmetros são exigidos para a criação de uma instância única de um local de porta.
Observe que o exemplo não inclui nenhuma informação de endereço. É possível criar uma entrada de porta no Servidor de Informações de Local sem associá-la a um endereço. Porém, dependendo dos locais de sub-rede ou de comutador que tenham sido definidos, as chamadas de emergência roteadas por esta porta podem não conter informações suficientes para que o operador do serviço de emergência identifique um local.
IMPORTANTE: Se um local de porta LIS com esta combinação de chaves já existir, ele será substituído pelos valores deste comando. Isso significa que, se esta porta estivesse associada a um endereço (um local físico), essa associação não existiria mais porque não incluímos nenhuma informação de local no comando. O local continuará existindo no banco de dados de locais, mas não será associado à porta.
-------------------------- Exemplo 2 --------------------------
Set-CsLisPort -ChassisID 99-99-99-99-99-99 -PortID 4200 -PortIdSubType 1 -Location "30/1000" -HouseNumber 1234 -PreDirectional NE -StreetName First -StreetSuffix Avenue -City Redmond -State WA -Country US -PostalCode 99999
O Exemplo 2 atualiza a porta criada no Exemplo 1, adicionando informações de endereço. Se o endereço não existir no banco de dados de locais, o cmdlet criará esse local.
-------------------------- Exemplo 3 --------------------------
$a = Get-CsLisPort | Where-Object {$_.ChassisID -eq "99-99-99-99-99-88"}
$a | Set-CsLisPort -Location "30/1000" -HouseNumber 1234 -StreetName First -StreetSuffix Avenue -City Redmond -State WA -Country US -PostalCode 99999
Este exemplo atualiza todos os locais definidos para portas com um endereço MAC (ChassisID) de 99-99-99-99-99-88. A primeira linha do exemplo começa chamando Get-CsLisPort para recuperar todas as portas que tenham sido definidas no serviço LIS. Essa coleção de portas é canalizada para o cmdlet Where-Object, que encontra todos os itens da coleção com ChassisID igual a (-eq) 99-99-99-99-99-88. Essa coleção de portas com ChassisID 99-99-99-99-99-88 é atribuída à variável $a.
Na segunda linha do exemplo, canalizamos o conteúdo da variável $a (a coleção de portas LIS com ChassisID 99-99-99-99-99-88) para o cmdlet Set-CsLisPort. O cmdlet atualiza cada item dessa coleção com os valores dos parâmetros especificados (Location, HouseNumber, StreetName, StreetSuffix, City, State, Country e PostalCode).