Compartir a través de

  • Artículo

Set-CsVoicePolicy

 

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

Modifica una directiva de voz existente.

Sintaxis

Set-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>] [-Name <String>] [-PreventPSTNTollBypass <$true | $false>] [-PstnUsages <PSListModifier>] [-WhatIf [<SwitchParameter>]]

Set-CsVoicePolicy [-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>] [-Instance <PSObject>] [-Name <String>] [-PreventPSTNTollBypass <$true | $false>] [-PstnUsages <PSListModifier>] [-WhatIf [<SwitchParameter>]]

Descripción detallada

Este cmdlet modifica una directiva de voz existente. 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. Use este cmdlet para cambiar la configuración que habilita y deshabilita muchas de estas características.

Quién puede ejecutar este cmdlet: de forma predeterminada, están autorizados para ejecutar el cmdlet Set-CsVoicePolicy 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-CsVoicePolicy"}

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Opcional

Cadena de caracteres

Un identificador único que identifica el ámbito y, en algunos casos, el nombre de la directiva.

Instance

Opcional

VoicePolicy

Permite enviar una referencia a un objeto al cmdlet, en lugar de definir valores de parámetros individuales. Este objeto debe ser de tipo VoicePolicy y puede recuperarse llamando al cmdlet Get-CsVoicePolicy.

AllowCallForwarding

Opcional

Booleano

Si este parámetro está definido como True, los usuarios asignados a esta directiva pueden transferir llamadas. Si está definido en False, las llamadas no pueden transferirse.

AllowPSTNReRouting

Opcional

Booleano

Si este parámetro está definido como 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 (RTC) si el grupo de servidores o la red WAN no está disponible.

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 habilitan las llamadas simultáneas. Si el parámetro está definido en False, las llamadas simultáneas no pueden configurarse para ningún usuario que esté asignado a esta directiva.

Description

Opcional

Cadena de caracteres

Descripción de la directiva de voz.

Longitud máxima: 1040 caracteres.

EnableBWPolicyOverride

Opcional

Booleano

Las directivas se pueden definir para limitar el ancho de banda y definir otras propiedades que estén relacionadas con la configuración de red. Al definir este parámetro en True, se permite la invalidación de las directivas. Es decir, si este parámetro está definido como 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).

EnableCallPark

Opcional

Booleano

La Aplicación de estacionamiento de llamadas permite retener o estacionar una llamada en un determinado número dentro de un intervalo de números para recuperarla más tarde. Si se define este parámetro en True, se habilita esta aplicación para los usuarios asignados a esta directiva. 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.

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.

EnableDelegation

Opcional

Booleano

La delegación de llamada permite a un usuario responder a llamadas de otro usuario o hacer 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.

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.

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.

Name

Opcional

Cadena de caracteres

Un nombre descriptivo que identifica a esta directiva.

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 como True, las llamadas se enviarán a través de la RTC y esto conllevará gastos, en lugar de establecer la conexión a través de la red y evitar los costes.

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 agregarse cualquier valor de cadena de caracteres a esta lista, siempre y cuando el valor exista en la lista de usos RTC global. (No están permitidas las cadenas de caracteres duplicadas. Todas las cadenas de caracteres deben ser únicas.) La lista de usos de RTC puede recuperarse llamando al cmdlet Get-CsPstnUsage.

Tenga en cuenta que si usa este parámetro para quitar todos los usos de RTC de la directiva, los usuarios con esta directiva no podrán realizar llamadas salientes a través de la red RTC.

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.WritableConfig.Policy.Voice.VoicePolicy. Acepta la entrada por canalización de objetos de directiva de voz.

Tipos de valores devueltos

Este cmdlet no devuelve un objeto o valor. En su lugar, configura instancias del objeto Microsoft.Rtc.Management.WritableConfig.Voice.VoicePolicy.

Ejemplo

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

Set-CsVoicePolicy UserVoicePolicy2 -AllowSimulRing $false -PstnUsages @{remove="Local"}

En este ejemplo se define la propiedad AllowSimulRing en False para la directiva por usuario UserVoicePolicy2, 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 quita la cadena de caracteres "Local" de la lista de usos de RTC para esta directiva. (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 2 --------------------------

$a = Get-CsPstnUsage
Set-CsVoicePolicy -Identity site:Redmond -PstnUsages @{replace=$a.Usage}

En este ejemplo se modifica la directiva de voz del sitio Redmond, de modo que todos los usos de RTC definidos en 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 de la organización y guardarlo en la variable $a. En la segunda línea, se llama a Set-CsVoicePolicy para modificar la directiva de voz del sitio Redmond. Se transfiere un valor al parámetro PstnUsages para reemplazar la lista actual de usos de la directiva por la lista del conjunto global de usos de RTC. Preste atención a la sintaxis del valor reemplazado: $a.Usage. Hace referencia a la propiedad Usage de la configuración de usos RTC, que contiene la lista de usos RTC.