• Artículo

Remove-CsMediaConfiguration

 

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

Quita la recopilación especificada de opciones de configuración de medios

Sintaxis

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

Descripción detallada

El cmdlet quita la recopilación de las configuraciones de medios. Estas configuraciones se relacionan con llamadas de audio y vídeo entre extremos de clientes.

Este cmdlet también puede usarse para quitar la configuración de material multimedia global. Aunque en este caso no se quita realmente la configuración, simplemente se restablecen las opciones en los valores predeterminados.

Quiénes pueden ejecutar este cmdlet: De forma predeterminada, los miembros de los grupos siguientes están autorizados a ejecutar el cmdlet Remove-CsMediaConfiguration de forma local: 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-CsMediaConfiguration"}

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Requerido

Identidad Xds

Identificador único de las configuraciones de material multimedia que quiere quitar. Este identificador especifica el ámbito al que se aplica esta configuración (global, del sitio o por usuario).

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.Settings.Media.MediaSettings. Acepta entradas canalizadas de los objetos de configuración de medios.

Tipos de valores devueltos

Quita un objeto de tipo Microsoft.Rtc.Management.WritableConfig.Settings.Media.MediaSettings.

Ejemplo

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

Remove-CsMediaConfiguration -Identity site:Redmond1

En el Ejemplo 1, se usa Remove-CsMediaConfiguration para eliminar la recopilación de configuraciones de material multimedia con la identidad site:Redmond1. Cuando las configuraciones de material multimedia se quitan del ámbito del sitio, dicho sitio comenzará a usar automáticamente las configuraciones multimedia globales.

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

Get-CsMediaConfiguration | Where-Object {$_.EncryptionLevel -eq "RequireEncryption"} | Remove-CsMediaConfiguration

En el ejemplo anterior, se usan tres cmdlets (Get-CsMediaConfiguration, Where-Object y Remove-CsMediaConfiguration) para quitar todas las recopilaciones de configuraciones multimedia que requieren cifrado de todas las partes involucradas en la conversación. Para ello, se usa primero Get-CsMediaConfiguration para devolver todas las recopilaciones de configuraciones multimedia de la organización. A continuación, se transfiere esta información a Where-Object, que aplica un filtro para restringir los datos que se envían a las recopilaciones en las que la propiedad EncryptionLevel equivale a (-eq) RequireEncryption. Finalmente, los datos filtrados se transfieren a Remove-CsMediaConfiguration, que quita todos los elementos del conjunto.

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

Get-CsMediaConfiguration -Filter service:* | Remove-CsMediaConfiguration

En este ejemplo, se quitan todas las configuraciones multimedia definidas en el ámbito de servicio, es decir, las que se aplican a un servicio específico. Para ello, primero se llama a Get-CsMediaConfiguration usando el filtro service:*. Este filtro recupera todas las recopilaciones de configuraciones multimedia con una identidad que empiece por "service;", es decir, todas las recopilaciones del ámbito de servicio. A continuación, este conjunto de recopilaciones se envía a Remove-CsMediaConfiguration, que las quita todas.