Partager via

  • Article

Remove-CsMediaConfiguration

 

Dernière rubrique modifiée : 2012-03-26

Supprime la collection spécifiée des paramètres de configuration multimédia.

Syntaxe

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

Description détaillée

Cette cmdlet supprime une collection des paramètres multimédia. Ces paramètres sont liés aux appels audio et vidéo entre les points de terminaison.

Cette cmdlet peut aussi être utilisée pour supprimer les paramètres multimédias globaux. Toutefois, dans ce cas, les paramètres ne seront pas vraiment supprimés ; ils seront simplement réinitialisés avec leurs valeurs par défaut.

Personnes autorisées à exécuter cette cmdlet : Par défaut, les membres des groupes qui suivent sont autorisés à exécuter localement la cmdlet Remove-CsMediaConfiguration : RTCUniversalServerAdmins. Pour retourner une liste de tous les rôles RBAC (Contrôle d’accès basé sur un rôle) auxquels cette cmdlet a été affectée (y compris les rôles RBAC personnalisés créés par vos soins), exécutez la commande suivante à l’invite Windows PowerShell :

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

Paramètres

Paramètre Obligatoire Type Description

Identity

Obligatoire

XdsIdentity

Identificateur unique des paramètres de configuration multimédia que vous souhaitez supprimer. Cet identificateur spécifie l’étendue dans laquelle cette configuration est appliquée (globale, Site ou Service).

Force

Facultatif

Paramètre de commutateur

Supprime les invites de confirmation qui s’affichent avant d’effectuer des modifications.

WhatIf

Facultatif

Paramètre de commutateur

Décrit ce qui se passe si vous exécutez la commande sans l’exécuter réellement.

Confirm

Facultatif

Paramètre de commutateur

Vous demande confirmation avant d’exécuter la commande.

Types d’entrées

Objet Microsoft.Rtc.Management.WritableConfig.Settings.Media.MediaSettings. Accepte la saisie de données transmises via le pipeline pour les objets de configuration multimédia.

Types de retours

Supprime un objet de type Microsoft.Rtc.Management.WritableConfig.Settings.Media.MediaSettings.

Exemple

-------------------------- Exemple 1 --------------------------

Remove-CsMediaConfiguration -Identity site:Redmond1

Dans l’exemple 1, Remove-CsMediaConfiguration permet de supprimer les configurations multimédias dont l’identité est l’identité site:Redmond1. Lorsque des paramètres multimédias sont supprimés de l’étendue Site, ce site commencera automatiquement à utiliser les paramètres multimédias globaux.

-------------------------- Exemple 2 --------------------------

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

Dans l’exemple précédent, trois cmdlets (Get-CsMediaConfiguration, Where-Object et Remove-CsMediaConfiguration) sont utilisées pour supprimer toutes les collections de configurations multimédias dans lesquelles le chiffrement est requis pour toutes les parties impliquées dans la conversation. Pour ce faire, Get-CsMediaConfiguration est d’abord utilisée pour retourner toutes les collections de configurations multimédias de l’organisation. Ces informations sont alors redirigées vers Where-Object, qui applique un filtre limitant les données du pipeline aux collections dans lesquelles la propriété EncryptionLevel est égale à (-eq) RequireEncryption. Enfin, cet ensemble de données filtré est transmis à Remove-CsMediaConfiguration, qui supprime chacun des éléments qu’il contient.

-------------------------- Exemple 3 --------------------------

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

Dans cet exemple, toutes les configurations multimédias définies dans l’étendue Service (ce qui signifie que la configuration s’applique à un service spécifique) sont supprimées. Cette opération s’effectue en appelant d’abord Get-CsMediaConfiguration via le filtre service:*. Ce filtre extrait toutes les collections de configurations multimédias dont l’identité commence par service, c’est-à-dire toutes les collections de l’étendue Service. Cet ensemble de collections est alors redirigé vers Remove-CsMediaConfiguration, qui les supprime toutes.