Partager via

  • Article

Remove-CsAVEdgeConfiguration

 

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

Vous permet de supprimer une collection de paramètres de configuration appliqués aux ordinateurs exécutant le service Edge d’accès (ces ordinateurs sont également appelés serveurs Edge A/V). Les serveurs Edge A/V permettent aux utilisateurs internes de partager des données audio et vidéo avec des utilisateurs externes (c’est-à-dire des utilisateurs non connectés à votre réseau interne).

Syntaxe

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

Description détaillée

Un serveur Edge A/V permet d’échanger du trafic audio et vidéo à travers le pare-feu d’une organisation. Ainsi, les utilisateurs peuvent utiliser Microsoft Lync Server 2010 sur Internet, puis échanger des données audio et vidéo avec des utilisateurs connectés au système à l’intérieur du pare-feu. Les paramètres de configuration d’un serveur Edge peuvent être attribués au niveau de l’étendue globale et des étendues Site et Service. Les paramètres de configuration Edge A/V permettent aux administrateurs, par exemple, de gérer la durée de validité d’une authentification utilisateur avant son renouvellement ou de limiter la bande passante disponible pour un seul utilisateur ou un seul port.

La cmdlet Remove-CsAVEdgeConfiguration permet de supprimer les paramètres de configuration Edge A/V appliqués au niveau de l’étendue Site ou Service. La cmdlet peut également être exécutée sur les paramètres globaux. Ces derniers ne seront toutefois pas supprimés. Toutes les propriétés de la collection globale seront en revanche réinitialisées à 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-CsAVEdgeConfiguration : 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-CsAVEdgeConfiguration"}

Paramètres

Paramètre Obligatoire Type Description

Identity

Obligatoire

XdsIdentity

Identificateur unique des paramètres de configuration de périphérie A/V à supprimer. Pour « supprimer » la collection globale, utilisez la syntaxe suivante : -Identity global. (Comme mentionné précédemment, les paramètres globaux ne peuvent pas être supprimés et les propriétés ne peuvent être redéfinies qu’à leurs valeurs par défaut.) Pour supprimer une collection de sites, utilisez une syntaxe de type : -Identity site:Redmond. Les paramètres configurés au niveau de l’étendue Service doivent être appelés suivant une syntaxe similaire à celle-ci :

-Identity service:EdgeServer:atl-cs-001.litwareinc.com

Vous ne pouvez utiliser de caractères génériques pour spécifier une identité de stratégie.

Force

Facultatif

Paramètre de commutateur

Supprime l’affichage de tous les messages d’erreur récupérable susceptibles d’apparaître lors de l’exécution de la commande.

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.Edge.MediaRelaySettings. Remove-CsAVEdgeConfiguration accepte la saisie de données transmises via le pipeline pour les objets des paramètres de relais multimédia. Ces objets sont extraits par l’exécution de la cmdlet Get-CsAVEdgeConfiguration.

Types de retours

Remove-CsAVEdgeConfiguration ne retourne aucune valeur ni objet. Au lieu de cela, la cmdlet supprime les instances de l’objet Microsoft.Rtc.Management.WritableConfig.Settings.Edge.MediaRelaySettings.

Exemple

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

Remove-CsAVEdgeConfiguration -Identity site:Redmond

La commande ci-dessus supprime les paramètres de configuration de périphérie A/V dont l’identité est site:Redmond. Une fois les paramètres supprimés, les serveurs Edge A/V du site Redmond seront régis par les paramètres de configuration globaux.

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

Get-CsAVEdgeConfiguration -Filter "service:*" | Remove-CsAVEdgeConfiguration

Dans l’exemple 2, tous les paramètres de configuration Edge A/V appliqués au niveau de l’étendue Service sont supprimés. Pour ce faire, la commande appelle d’abord Get-CsAVEdgeConfiguration avec le paramètre Filter. La valeur de filtre "service:*" garantit que seuls les paramètres configurés au niveau de l’étendue Service sont retournés. Cette collection filtrée est alors redirigée vers Remove-CsAVEdgeConfiguration, qui supprime chaque élément de la collection.

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

Get-CsAVEdgeConfiguration | Where-Object {$_.MaxBandwidthPerUserKB -lt 5000} | Remove-CsAVEdgeConfiguration

La commande illustrée dans l’exemple 3 supprime tous les paramètres de configuration Edge A/V dont la valeur de la propriété MaxBandwidthPerUserKB est inférieure à 5 000 Kbits/s. Pour effectuer cette tâche, la commande appelle d’abord Get-CsAVEdgeConfiguration sans paramètres supplémentaires afin de retourner une collection de tous les paramètres Edge A/V utilisés dans votre organisation. Cette collection est redirigée vers la cmdlet Where-Object qui ne sélectionne que les paramètres pour lesquels la propriété MaxBandwidthPerUserKB est inférieure à 5 000. La collection filtrée est alors redirigée vers Remove-CsAVEdgeConfiguration qui supprime chaque élément de cette collection.