Compartir a través de

  • Artículo

New-CsVoicePolicy

 

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

Crea una directiva de voz.

Sintaxis

New-CsVoicePolicy -Identity <XdsIdentity> [-AllowCallForwarding <$true | $false>] [-AllowPSTNReRouting <$true | $false>] [-AllowSimulRing <$true | $false>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-EnableBWPolicyOverride <$true | $false>] [-EnableCallPark <$true | $false>] [-EnableCallTransfer <$true | $false>] [-EnableDelegation <$true | $false>] [-EnableMaliciousCallTracing <$true | $false>] [-EnableTeamCall <$true | $false>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-Name <String>] [-PreventPSTNTollBypass <$true | $false>] [-PstnUsages <PSListModifier>] [-WhatIf [<SwitchParameter>]]

Descripción detallada

Este cmdlet crea una directiva de voz. Las directivas de voz se usan para administrar características de Enterprise Voice, como las llamadas simultáneas (la posibilidad de recibir una segunda llamada cada vez que alguien llama al número de una oficina) o el desvío de llamadas. La directiva creada mediante este cmdlet determina si muchas de estas características están habilitadas o deshabilitadas.

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

Parámetros

Parameter Requerido Tipo Descripción

Identity

Requerido

Identidad Xds

Identificador único que especifica el ámbito o el nombre de la directiva. Los valores válidos para este cmdlet son site:<site name> (donde <site name> es el nombre del sitio de Microsoft Lync Server 2010 al que se aplica esta directiva, por ejemplo, site:Redmond) y una cadena que designa una directiva por usuario, por ejemplo, RedmondVoicePolicy. Existe una directiva global de manera predeterminada.

AllowCallForwarding

Opcional

Booleano

Si este parámetro está establecido en True, las llamadas pueden desviarse. Si está definido en False, las llamadas no pueden desviarse.

Valor predeterminado: True

AllowPSTNReRouting

Opcional

Booleano

Si este parámetro está establecido en True, las llamadas a números internos de otro grupo de servidores se enrutarán a través de la red telefónica conmutada pública si el grupo de servidores o red WAN no está disponible.

Valor predeterminado: True

AllowSimulRing

Opcional

Booleano

Las llamadas simultáneas son una característica que permite que varios teléfonos reciban una misma llamada al marcar un solo número. Al definir este parámetro en True, se habilita esta característica. Si el parámetro está establecido en False, no se podrán configurar llamadas simultáneas para ningún usuario que esté asignado a esta directiva.

Valor predeterminado: True

Description

Opcional

Cadena de caracteres

Una descripción de la directiva de voz.

Longitud máxima: 1040 caracteres.

EnableBWPolicyOverride

Opcional

Booleano

Las directivas se pueden definir para administrar la configuración de red, incluida la limitación del ancho de banda. Al definir este parámetro en True, se permite la invalidación de las directivas. Es decir, si es True, no se realizarán comprobaciones de ancho de banda y las llamadas se realizarán al margen de la configuración de control de admisión de llamadas (CAC).

Valor predeterminado: False

EnableCallPark

Opcional

Booleano

La aplicación Aplicación de estacionamiento de llamadas permite retener o estacionar una llamada de un número determinado de un intervalo de números para recuperarla más tarde. Al definir este parámetro en True, se habilita esta aplicación. Si está definido en False, los usuarios que estén asignados a esta directiva no podrán estacionar llamadas que se hayan marcado para su número de teléfono.

Valor predeterminado: False

EnableCallTransfer

Opcional

Booleano

Determina si las llamadas se pueden transferir a otro número. Si este parámetro está definido en True, las llamadas pueden transferirse; si está definido en False, las llamadas no pueden transferirse.

Valor predeterminado: True

EnableDelegation

Opcional

Booleano

La delegación de llamadas permite a un usuario responder a las llamadas por otro usuario o realizar llamadas en nombre de otro usuario. Por ejemplo, un coordinador puede configurar la delegación de llamadas para que tanto su teléfono como el de un administrador reciban todas las llamadas entrantes. Al definir este parámetro en True, los usuarios con esta directiva pueden definir la delegación de llamadas. Al definir este parámetro en False, se deshabilita la delegación de llamadas.

Valor predeterminado: True

EnableMaliciousCallTracing

Opcional

Booleano

La grabación de llamadas malintencionadas es una opción estándar que se proporciona para grabar las llamadas que un usuario designe como malintencionadas. Las llamadas se pueden grabar aunque el ID del autor de la llamada esté bloqueado. La grabación sólo está disponible para las autoridades apropiadas y, en ningún caso, para el usuario. Al definir esta propiedad en True, se habilita la posibilidad de establecer una grabación en las llamadas malintencionadas.

Valor predeterminado: False

EnableTeamCall

Opcional

Booleano

La llamada de equipo permite a un usuario designar un grupo de usuarios cuyos teléfonos sonarán cuando el número del usuario reciba una llamada. Esta característica es útil en los equipos donde, por ejemplo, cualquiera de los miembros del equipo puede responder a las llamadas entrantes de clientes. Al definir este parámetro en True, se habilita esta característica.

Valor predeterminado: True

Name

Opcional

Cadena de caracteres

Un nombre para mostrar que identifica a esta directiva.

Valor predeterminado: DefaultPolicy

PreventPSTNTollBypass

Opcional

Booleano

Las tarifas RTC se conocen más habitualmente como tarifas de larga distancia. En algunas ocasiones, las organizaciones pueden omitir estas tarifas mediante la implementación de una solución de voz sobre IP (VoIP), que permite a las sucursales conectarse mediante llamadas en red. Al definir este parámetro en True, las llamadas se enviarán a través de la RTC y se incurrirá en gastos, en lugar de establecer la conexión a través de la red y omitir las tarifas.

Valor predeterminado: False

PstnUsages

Opcional

Modificador de lista PS

Una lista de usos de RTC disponibles para esta directiva. El uso de RTC vincula una directiva de voz con una ruta telefónica.

Puede poner cualquier valor de cadena en esta lista siempre que dicho valor esté incluido en la lista global actual de usos de RTC. (No están permitidas las cadenas duplicadas. Todas las cadenas deben ser únicas.) La lista de usos de RTC se puede recuperar mediante una llamada al cmdlet Get-CsPstnUsage.

De forma predeterminada, esta lista está vacía. Si no proporciona un valor para este parámetro, recibirá un mensaje de advertencia donde se indicará que los usuarios a los que se otorgue esta directiva no podrán realizar llamadas RTC salientes.

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

Este cmdlet crea una instancia del objeto Microsoft.Rtc.Management.WritableConfig.Voice.VoicePolicy.

Ejemplo

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

New-CsVoicePolicy -Identity UserVoicePolicy1

En este ejemplo se crea una directiva de voz por usuario con los valores predeterminados y cuya Identity es UserVoicePolicy1.

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

New-CsVoicePolicy UserVoicePolicy2 -AllowSimulRing $false -PstnUsages @{add = "Local"}

En este ejemplo se crea una directiva de voz por usuario con una Identity de UserVoicePolicy2 y se establece la propiedad AllowSimulRing en False, lo que quiere decir que los usuarios que tengan asignada esta directiva no pueden usar las llamadas simultáneas, una característica que determina si se puede establecer un segundo teléfono (como un teléfono móvil) para que suene cada vez que el teléfono de la oficina del usuario reciba una llamada. Este comando también agrega "Local" a la lista de usos de RTC, lo que asocia esta directiva de voz con una ruta de voz que también utiliza el uso de RTC local. (Tenga en cuenta que el parámetro Identity no está especificado de forma explícita. El parámetro Identity es un parámetro de posición; por lo tanto, si coloca el valor de identidad al principio de la lista de parámetros, no es necesario que indique de forma explícita que se trata del valor de Identity.)

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

$a = Get-CsPstnUsage
New-CsVoicePolicy site:Redmond -PstnUsages @{add = $a.Usage}

En este ejemplo, se crea una directiva de voz para el sitio Redmond y todos los usos de RTC definidos para la organización se aplican a la directiva. En la primera línea del ejemplo se llama al cmdlet Get-CsPstnUsage para recuperar el conjunto global de usos de RTC para la organización y guardarlo en la variable $a. En la segunda línea, se llama a New-CsVoicePolicy para crear una directiva de voz para el sitio Redmond. Se transfiere un valor al parámetro PstnUsages para agregar a esta directiva la lista incluida en el conjunto global de usos de RTC. Preste atención a la sintaxis de agregar value: $a.Usage. Hace referencia a la propiedad Usage de la configuración de usos de RTC, que contiene la lista de usos de RTC.