Compartir a través de

  • Artículo

Set-CsUnassignedNumber

 

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

Modifica un intervalo de números no asignados y las reglas de enrutamiento que se aplican a dichos números.

Sintaxis

Set-CsUnassignedNumber [-Identity <XdsGlobalRelativeIdentity>] [-NumberRangeStart <String>] [-NumberRangeEnd <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-Priority <Int32>] [-WhatIf [<SwitchParameter>]]

Set-CsUnassignedNumber [-Identity <XdsGlobalRelativeIdentity>] [-NumberRangeStart <String>] [-NumberRangeEnd <String>] -ExUmAutoAttendantPhoneNumber <String> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-Priority <Int32>] [-WhatIf [<SwitchParameter>]]

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

Set-CsUnassignedNumber [-Identity <XdsGlobalRelativeIdentity>] [-NumberRangeStart <String>] [-NumberRangeEnd <String>] -AnnouncementService <String> -AnnouncementName <String> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-Priority <Int32>] [-WhatIf [<SwitchParameter>]]

Set-CsUnassignedNumber [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-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 a determinados destinos cuando se llama a un número sin asignar. Este cmdlet modifica la configuración que determina dicho enrutamiento.

Para modificar las opciones de este cmdlet, el sistema debe tener definido Announcements o tener configurado un operador automático de Mensajería unificada de Exchange (UM). Para averiguar si Announcements está definido, llame al cmdlet Get-CsAnnouncement. Para crear un Announcement nuevo, 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, están autorizados para ejecutar el cmdlet Set-CsUnassignedNumber localmente los miembros de los siguientes grupos: 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 (incluidos los roles de RBAC personalizados que haya creado), ejecute el siguiente comando en el símbolo del sistema de Windows PowerShell:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsUnassignedNumber"}

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Opcional

Cadena de caracteres

Nombre único del intervalo de números no asignados que se modificará.

Instance

Opcional

DisplayAnnouncementVacantNumberRange

Referencia a un objeto que contiene configuraciones de números no asignados. Este objeto debe ser de tipo Microsoft.Rtc.Management.Voice.Helpers.DisplayAnnouncementVacantNumberRange y puede recuperarse llamando al cmdlet Get-CsUnassignedNumber.

AnnouncementName

Requerido

Cadena de caracteres

El nombre del anuncio que se usará para administrar las llamadas recibidas en los números del intervalo.

AnnouncementService

Requerido

Cadena de caracteres

Nombre de dominio completo (FQDN) o ID de servicio del servidor de anuncios.

ExUmAutoAttendantPhoneNumber

Requerido

Cadena de caracteres

Número de teléfono del operador automático de Mensajería unificada de Exchange al que se erutarán las llamadas a números incluidos en el intervalo. 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

Opcional

Cadena de caracteres

Primer número del intervalo de números no asignados. 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})?. Esto significa que el número puede comenzar con la cadena de caracteres tel: (si no especifica la cadena de caracteres, 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

Opcional

Cadena de caracteres

Último número del intervalo de números no asignados. Debe ser mayor o igual que el número de NumberRangeStart. Para especificar un único número, use el mismo número para los valores 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})?. Esto significa que el número puede comenzar con la cadena de caracteres tel: (si no especifica la cadena de caracteres, 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 números no asignados se superpongan. Si un número está incluido en varios intervalos, se usará el intervalo con la prioridad más alta.

Force

Opcional

Parámetro modificador

Suprime los mensajes de confirmación que, de lo contrario, se mostrarían antes de realizar 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

Objeto Microsoft.Rtc.Management.Voice.Helpers.DisplayAnnouncementVacantNumberRange. Acepta la entrada por canalización de objetos de números sin asignar.

Tipos de valores devueltos

Este cmdlet no devuelve un valor. Modifica un objeto de tipo Microsoft.Rtc.Management.Voice.Helpers.DisplayAnnouncementVacantNumberRange.

Ejemplo

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

Set-CsUnassignedNumber -Identity UNSet1 -NumberRangeStart "+14255551000" -NumberRangeEnd "+14255551900"

En este ejemplo se modifica el intervalo de números no asignados llamado UNSet1. Primero transferimos al parámetro Identity el valor UNSet1, el nombre del intervalo de números sin asignar que queremos modificar. Usamos los parámetros NumberRangeStart (+14255551000) y NumberRangeEnd (+14255551900) para definir el intervalo de números sin asignar al que se aplicará el anuncio o el operador automático especificado.

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

Get-CsUnassignedNumber | Where-Object {$_.AnnouncementName -match "Welcome"} | Set-CsUnassignedNumber -AnnouncementService ApplicationServer:redmond.litwareinc.com -AnnouncementName "Help Desk Announcement"

En este ejemplo se modifica el anuncio de todas las configuraciones de intervalo de números no asignados que tengan un anuncio con la cadena de caracteres "Welcome" en el nombre. Primero se llama a Get-CsUnassignedNumber para recuperar todas las configuraciones de números no asignados. La recopilación de configuraciones se transfiere a Where-Object, que selecciona sólo las configuraciones en las que la propiedad AnnouncementName contiene (-match) la cadena de caracteres Welcome. Estas configuraciones se transfieren a Set-CsUnassignedNumber, donde modificamos el identificador de servidor de aplicación del servicio de anuncios (ApplicationServer:redmond.litwareinc.com) con el parámetro AnnouncementService, y el nombre del nuevo anuncio (Help Desk Announcement) con el parámetro AnnouncementName. Tenga en cuenta que aunque el nuevo anuncio tenga un nombre diferente pero el mismo identificador de servicio, deberá especificar el identificador de servicio con el nombre de todos modos.