Test-CsLisCivicAddress
Última modificación del tema: 2012-03-25
Comprueba una o varias direcciones postales con respecto a la guía de direcciones principal.
Sintaxis
Test-CsLisCivicAddress [-City <String>] [-Confirm [<SwitchParameter>]] [-Country <String>] [-HouseNumber <String>] [-HouseNumberSuffix <String>] [-PostalCode <String>] [-PostDirectional <String>] [-PreDirectional <String>] [-State <String>] [-StreetName <String>] [-StreetSuffix <String>] [-UpdateValidationStatus <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Descripción detallada
En una implementación de Enterprise Voice con Enhanced 9-1-1 (E9-1-1), las ubicaciones de los usuarios se determinan en función de asignaciones de ubicación que asignan una subred, puerto, conmutador o punto de acceso inalámbrico a una ubicación. (Ante la ausencia de una conexión para una ubicación asignada, es posible que se le pida al usuario que especifique su ubicación manualmente.) El proveedor de enrutamiento de red de E9-1-1 debe validar las direcciones de estas ubicaciones con respecto a la guía de direcciones principal (MSAG). Este cmdlet utiliza el servicio web de dicho proveedor para validar direcciones asignadas. Puede llamar al cmdlet Set-CsLisServiceProvider para configurar un proveedor de servicio.
Si desea actualizar la propiedad MSAGValid para la dirección postal, asegúrese de incluir el parámetro UpdateValidationStatus en la llamada a Test-CsLisCivicAddress. Use el cmdlet Get-CsLisCivicAddress para recuperar direcciones postales.
Quién puede ejecutar este cmdlet: de forma predeterminada, los miembros de los siguientes grupos tienen autorización para ejecutar el cmdlet Test-CsLisCivicAddress localmente: RTCUniversalServerAdmins. Para obtener una lista de todos los roles de control de acceso basado en rol (RBAC), este rol se ha asignado (así como cualquier otro rol RBAC personalizado que haya creado) para ejecutar el siguiente comando desde el símbolo del sistema Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Test-CsLisCivicAddress"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
City |
Opcional |
Cadena de caracteres |
La ciudad de la ubicación. Longitud máxima: 64 caracteres. |
Country |
Opcional |
Cadena de caracteres |
País/región de la ubicación. Longitud máxima: 2 caracteres |
HouseNumber |
Opcional |
Cadena de caracteres |
El número de edificio de la ubicación. En el caso de una compañía, se trata del número de la calle en el que se encuentra. Longitud máxima: 10 caracteres |
HouseNumberSuffix |
Opcional |
Cadena de caracteres |
Información adicional sobre el número del edificio, como 1/2 o A. Por ejemplo, 1234 1/2 Oak Street o 1234 A Elm Street. Longitud máxima: 5 caracteres |
PostalCode |
Opcional |
Cadena de caracteres |
El código postal asociado a la ubicación. Longitud máxima: 10 caracteres |
PostDirectional |
Opcional |
Cadena de caracteres |
La designación de dirección del nombre de una calle. Por ejemplo, NE o NO en Main Street NE o 7th Avenue NO. Longitud máxima: 2 caracteres |
PreDirectional |
Opcional |
Cadena de caracteres |
La designación de dirección del nombre de una calle que precede al nombre de la calle. Por ejemplo, NE (Noreste) o NO (Noroeste). Longitud máxima: 2 caracteres |
State |
Opcional |
Cadena de caracteres |
La provincia o el estado asociado a la ubicación. Longitud máxima: 2 caracteres |
StreetName |
Opcional |
Cadena de caracteres |
El nombre de la calle de la ubicación. Longitud máxima: 60 caracteres |
StreetSuffix |
Opcional |
Cadena de caracteres |
El tipo de calle, como Calle, Avenida o Paseo. Longitud máxima: 10 caracteres |
UpdateValidationStatus |
Opcional |
Parámetro modificador |
La inclusión de este parámetro modificará la propiedad MSAGValid de la dirección postal dependiendo de si la dirección se valida a través de este cmdlet. Si la dirección es válida, MSAGValid se establecerá en True. Si se omite este parámetro, el valor de MSAGValid permanecerá sin cambios. |
WhatIf |
Opcional |
Parámetro modificador |
Describe lo que ocurriría si se ejecutara el comando sin ejecutarlo realmente. |
Confirm |
Opcional |
Parámetro modificador |
Solicita confirmación antes de ejecutar el comando. |
Tipos de entrada
Acepta entradas transferidas que contienen un objeto de dirección postal del servidor de información de ubicaciones (LIS).
Tipos de valores devueltos
Este cmdlet no devuelve un valor.
Ejemplo
-------------------------- Ejemplo 1 --------------------------
Test-CsLisCivicAddress -HouseNumber 1234 -HouseNumberSuffix "" -PreDirectional "" -StreetName Main -StreetSuffix St -PostDirectional "" -City Redmond -State WA -PostalCode 99999 -Country US -UpdateValidationStatus
Este comando valida la dirección con las propiedades que coinciden con los valores especificados en estos parámetros con respecto a la guía de direcciones principal. Tenga en cuenta que la inclusión del parámetro UdateValidationStatus al final: actualizará la propiedad MSAGValid de la dirección.
-------------------------- Ejemplo 2 --------------------------
Get-CsLisCivicAddress | Test-CsLisCivicAddress -UpdateValidationStatus
En este ejemplo se muestra cómo comprobar todas las direcciones postales del LIS. El ejemplo comienza con una llamada a Get-CsLisCivicAddress para recuperar todas las direcciones postales definidas en la base de datos de ubicaciones. Estas direcciones se transfieren a Test-CsLisCivicAddress, que usa el servicio web del proveedor de enrutamiento de red E9-1-1 para validarlas.