Get-CsUnassignedNumber
Última modificación del tema: 2012-03-23
Recupera uno o varios intervalos de números sin asignar y las reglas de enrutamiento que se aplican a estos números.
Sintaxis
Get-CsUnassignedNumber [-Identity <XdsGlobalRelativeIdentity>] [-LocalStore <SwitchParameter>]
Get-CsUnassignedNumber [-Filter <String>] [-LocalStore <SwitchParameter>]
Descripción detallada
Los números sin asignar son números de teléfono que se han asignado a una organización pero no a usuarios o teléfonos específicos. Microsoft Lync Server 2010 puede configurarse para enrutar las llamadas recibidas en números sin asignar a destinos específicos. Este cmdlet recupera uno o varios intervalos de números sin asignar que definen el enrutamiento.
Quién puede ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar el cmdlet Get-CsUnassignedNumber de forma local: RTCUniversalUserAdmins, RTCUniversalServerAdmins, RTCUniversalReadOnlyAdmin. Para devolver una lista de todos los roles de control de acceso basado en roles (RBAC) a los que se ha asignado este cmdlet (incluido cualquier otro rol RBAC personalizado que usted mismo haya creado), ejecute el siguiente comando desde Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsUnassignedNumber"}
Parámetros
Parámetro | Requerido | Tipo | Descripción |
---|---|---|---|
Identity |
Opcional |
XdsGlobalRelativeIdentity |
El nombre único del intervalo de números sin asignar que se va a recuperar. |
Filter |
Opcional |
Cadena de caracteres |
Realiza una búsqueda con caracteres comodín que permite restringir los resultados para obtener aquellas configuraciones de números sin asignar cuyas identidades coincidan con la cadena de caracteres comodín especificada. |
LocalStore |
Opcional |
Parámetro modificador |
Recupera la información del número sin asignar de la réplica local de Almacén de administración central, en lugar de recuperarla de Almacén de administración central. |
Tipos de entrada
Ninguno.
Tipos de valores devueltos
Devuelve un objeto de tipo Microsoft.Rtc.Management.Voice.Helpers.DisplayAnnouncementVacantNumberRange.
Ejemplo
-------------------------- Ejemplo 1 --------------------------
Get-CsUnassignedNumber
En el Ejemplo 1 se devuelve una colección de todos los números sin asignar configurados para su uso en la organización.
-------------------------- Ejemplo 2 --------------------------
Get-CsUnassignedNumber -Identity UNSet1
En el Ejemplo 2, el parámetro Identity se utiliza para limitar los datos recuperados a los números sin asignar que tienen Identity UNSet1. Puesto que las identidades deben ser únicas, este comando sólo devolverá el intervalo de números sin asignar especificado.
-------------------------- Ejemplo 3 --------------------------
Get-CsUnassignedNumber -Filter *Redmond*
En este ejemplo se usa el parámetro Filter para devolver una colección de todas las configuraciones de números sin asignar con los valores de Identity que incluyen la cadena de caracteres Redmond. Por ejemplo, este comando devolverá la configuración de números sin asignar con identidades tales como Redmond Numbers, Unassigned Redmond Numbers, UNRedmond, etc.
-------------------------- Ejemplo 4 --------------------------
Get-CsUnassignedNumber | Where-Object {$_.AnnouncementName -match "Welcome"}
En el Ejemplo 4, Get-CsUnassignedNumber y Where-Object se utilizan para recuperar una colección de todas las configuraciones de números sin asignar que incluyen la palabra Welcome en el nombre del anuncio. Para ello, el comando primero usa Get-CsUnassignedNumber para recuperar todas las configuraciones de números sin asignar. A continuación, la colección se transfiere a Where-Object, que aplica un filtro que limita los datos devueltos a números sin asignar que contengan la palabra Welcome en alguna parte del nombre del anuncio asignado.