Compartir a través de

  • Artículo

Remove-CsVoicePolicy

 

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

Quita la directiva de voz especificada.

Sintaxis

Remove-CsVoicePolicy -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Descripción detallada

Este cmdlet quita 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. Este cmdlet también puede usarse para quitar la directiva de voz global. Aunque en este caso no se quita realmente la directiva, solo se restablecen las opciones en los valores predeterminados.

Quiénes pueden ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar el cmdlet Remove-CsVoicePolicy localmente: RTCUniversalServerAdmins. Para obtener una lista de todos los roles de control de acceso basado en roles (RBAC) que se han asignado a este cmdlet (incluidos los roles personalizados RBAC que haya creado usted), ejecute el siguiente comando en el aviso de Windows PowerShell:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsVoicePolicy"}

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Requerido

Identidad Xds

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

Force

Opcional

Parámetro modificador

Suprime las solicitudes 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 entradas canalizadas de objetos de directivas de voz.

Tipos de valores devueltos

Este cmdlet no devuelve un valor. Elimina una instancia de un objeto Microsoft.Rtc.Management.WritableConfig.Policy.Voice.VoicePolicy.

Ejemplo

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

Remove-CsVoicePolicy -Identity UserVoicePolicy1

En este ejemplo, quita la configuración de la directiva de voz por usuario UserVoicePolicy1.

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

Get-CsVoicePolicy -Filter tag* | Remove-CsVoicePolicy

En este ejemplo, se quitan todas las configuraciones de directiva de voz que pueden asignarse a usuarios específicos. Primero se llama al cmdlet Get-CsVoicePolicy con un filtro de etiqueta*, que recupera todas las directivas de voz por usuario. A continuación, la recopilación de directivas se transfiere al cmdlet Remove-CsVoicePolicy que se quitará.