Compartir a través de

  • Artículo

New-CsUnassignedNumber

 

Última modificación del tema: 2012-03-26

Crea un nuevo intervalo de números sin asignar y las reglas de enrutamiento que se aplicarán a dichos números. Al ejecutar este cmdlet, se agregará una entrada a la tabla de enrutamiento de los números sin asignar.

Sintaxis

New-CsUnassignedNumber -Identity <XdsGlobalRelativeIdentity> -NumberRangeStart <String> -NumberRangeEnd <String> -AnnouncementService <String> -AnnouncementName <String> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-Priority <Int32>] [-WhatIf [<SwitchParameter>]]

New-CsUnassignedNumber -Identity <XdsGlobalRelativeIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-Priority <Int32>] [-WhatIf [<SwitchParameter>]]

New-CsUnassignedNumber -Identity <XdsGlobalRelativeIdentity> -NumberRangeStart <String> -NumberRangeEnd <String> -ExUmAutoAttendantPhoneNumber <String> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-Priority <Int32>] [-WhatIf [<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 no asignados a destinos específicos. Este cmdlet crea la configuración que define este enrutamiento.

Antes de ejecutar este cmdlet, el sistema debe tener anuncios definidos o un operador automático de Mensajería unificada de Exchange (UM) configurado. Para determinar si el servicio de anuncios está definido, llame al cmdlet Get-CsAnnouncement. Para crear un anuncio, llame a New-CsAnnouncement. Para comprobar la configuración de Operador automático de Mensajería unificada de Exchange, ejecute el cmdlet Get-CsExUmContact.

Quién puede ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos tienen autorización para ejecutar el cmdlet New-CsUnassignedNumber localmente: RTCUniversalServerAdmins. 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 "New-CsUnassignedNumber"}

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Requerido

XdsGlobalRelativeIdentity

Un nombre único para el intervalo de números sin asignar que se está creando. Todos los intervalos de números sin asignar son de ámbito global, de modo que el nombre que se especifique aquí debe ser único en toda la implementación de Lync Server 2010.

AnnouncementName

Requerido

Cadena de caracteres

El nombre del anuncio que se usará para administrar las llamadas recibidas por este intervalo de números.

AnnouncementService

Requerido

Cadena de caracteres

Nombre de dominio completo (FQDN) o ID de servicio del servidor de anuncios. Este parámetro solo es obligatorio si no ha especificado ningún valor para el parámetro ExUmAutoAttendantPhoneNumber.

ExUmAutoAttendantPhoneNumber

Requerido

Cadena de caracteres

Número de teléfono del Operador automático de Mensajería unificada de Exchange al que se enrutarán las llamadas a números incluidos en el intervalo. Este campo solo es obligatorio si no está usando ningún servicio de anuncios (en cuyo caso no asignará valores a los parámetros AnnouncementService ni AnnouncementName). El contacto de Operador automático de Mensajería unificada de Exchange debe estar configurado para poder asignar un valor a este parámetro.

NumberRangeStart

Requerido

Cadena de caracteres

El primer número del intervalo de números sin asignar. Debe ser menor o igual que el valor de NumberRangeEnd.

El número debe tener el mismo formato que la expresión regular (tel:)?(\+)?[1-9]\d{0,17}(;ext=[1-9]\d{0,9})?. Significa que el número puede comenzar con la cadena tel: (si no especifica la cadena, se agregará automáticamente), un signo más (+), y un dígito del 1 al 9. El número de teléfono puede tener hasta 17 dígitos y puede estar seguido de una extensión en formato ";ext=número de extensión".

NumberRangeEnd

Requerido

Cadena de caracteres

El último número del intervalo de números sin asignar. Debe ser mayor o igual que el número asignado a NumberRangeStart. Para especificar un intervalo de un solo número, utilice el mismo número en NumberRangeStart y NumberRangeEnd.

El número debe tener el mismo formato que la expresión regular (tel:)?(\+)?[1-9]\d{0,17}(;ext=[1-9]\d{0,9})?. Significa que el número puede comenzar con la cadena tel: (si no especifica la cadena, se agregará automáticamente), un signo más (+), y un dígito del 1 al 9. El número de teléfono puede tener hasta 17 dígitos y puede estar seguido de una extensión en formato ";ext=número de extensión".

Priority

Opcional

Int32

Es posible que los intervalos de números sin asignar coincidan parcialmente. Si un número está incluido en más de un intervalo, se aplicará el intervalo con mayor prioridad.

Force

Opcional

Parámetro modificador

Suprime las preguntas de confirmación que aparecerían antes de realizar cambios.

InMemory

Opcional

Parámetro modificador

Crea una referencia de objeto sin confirmar realmente el objeto como cambio permanente. Si se asigna la salida de este cmdlet llamado con este parámetro en una variable, puede realizar cambios en las propiedades de la referencia del objeto y después confirmar estos cambios, llamando a este conjunto coincidente de cmdlet, - cmdlet.

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

Ninguno.

Tipos de valores devueltos

Crea un objeto de tipo Microsoft.Rtc.Management.Voice.Helpers.DisplayAnnouncementVacantNumberRange.

Ejemplo

-------------------------- Ejemplo 1 --------------------------

New-CsUnassignedNumber -Identity UNSet1 -NumberRangeStart "+14255551000" -NumberRangeEnd "+14255551100" -AnnouncementService ApplicationServer:redmond.litwareinc.com -AnnouncementName "Welcome Announcement"

En este ejemplo se crea un intervalo de números sin asignar con el nombre UNSet1. Usamos los parámetros NumberRangeStart (+14255551000) y NumberRangeEnd (+14255551100) para definir el intervalo de números sin asignar al que se aplicará el anuncio especificado. Por último, para especificar el anuncio, primero utilizamos el parámetro AnnouncementService con el identificador de servicio del servidor de anuncios y, a continuación, pasamos el valor "Welcome Announcement" (Anuncio de bienvenida) al parámetro AnnouncementName. Recuerde que debe existir previamente en el sistema un anuncio con ese nombre.

-------------------------- Ejemplo 2 --------------------------

New-CsUnassignedNumber -Identity UNSet2 -NumberRangeStart "+14255552100" -NumberRangeEnd "+14255552200" -ExUmAutoAttendantPhoneNumber "+12065551234"

Este ejemplo crea un intervalo de números sin asignar con el nombre UNSet2. Como en el Ejemplo 1, usamos los parámetros NumberRangeStart (+14255552100) y NumberRangeEnd (+14255552200) para definir el intervalo de números sin asignar al que se aplicará el anuncio especificado. Sin embargo, en este ejemplo, en lugar de usar el servicio de anuncios, este intervalo de números utilizará el Operador automático de Mensajería unificada de Exchange. (El Operador automático es un solo número designado como número principal de la organización, que guía a los usuarios con avisos por voz para ayudarles a llegar al destino correspondiente). Para completar este comando, pasamos un número de teléfono al parámetro ExUmAutoAttendantPhoneNumber. Tenga en cuenta que Mensajería unificada de Exchange debe estar configurada y que este número debe ser un número de teléfono de un objeto de contacto existente en Active Directory Domain Services (AD DS). El contacto debe ser un contacto de Operador automático (la propiedad AutoAttendant del contacto debe ser True).

-------------------------- Ejemplo 3 --------------------------

New-CsUnassignedNumber -Identity UNSet2 -NumberRangeStart "+14255552100" -NumberRangeEnd "+14255552200" -ExUmAutoAttendantPhoneNumber "+12065551234" -Priority 2

El Ejemplo 3 es casi idéntico al Ejemplo 2: crea un intervalo de números sin asignar con el nombre UNSet2. La diferencia es que, en este ejemplo, hemos añadido el parámetro Priority, con un valor de 2 en este caso. Significa que, si se ha definido un intervalo de números sin asignar que coincide parcialmente con este y ese intervalo de números tiene mayor prioridad (un número de prioridad menor como, por ejemplo, 1), las llamadas se enrutarán según la configuración de ese intervalo en lugar de este.