Partager via


Remove-CsNetworkBandwidthPolicyProfile

 

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

Supprime un profil de stratégie de bande passante du réseau

Syntaxe

Remove-CsNetworkBandwidthPolicyProfile -Identity <XdsGlobalRelativeIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Description détaillée

La stratégie de bande passante utilisée dans le cadre du contrôle d’admission des appels (CAC) permet de définir des restrictions de bande passante pour des modes bien précis. (Dans Microsoft Lync Server 2010, seuls les modes audio et vidéo peuvent être soumis à des restrictions en matière de bande passante.) Cette cmdlet supprime un profil pour ces stratégies au sein du conteneur.

IMPORTANT : si un profil a été affecté à un site (à l’aide de la cmdlet New-CsNetworkSite ou Set-CsNetworkSite), à une stratégie intersite (à l’aide de la cmdlet New-CsNetworkInterSitePolicy ou Set-CsNetworkInterSitePolicy) ou à un lien de région réseau (à l’aide de la cmdlet New-CsNetworkRegionLink ou Set-CsNetworkRegionLink), il ne peut pas être supprimé. Vous recevrez une erreur si vous essayez de supprimer le profil en appelant Remove-CsNetworkBandwidthPolicyProfile. Vous devez d’abord supprimer le profil de tous les sites, stratégies intersites et liens de région réseau pour pouvoir supprimer le profil.

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-CsNetworkBandwidthPolicyProfile : 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-CsNetworkBandwidthPolicyProfile"}

Paramètres

Paramètre Obligatoire Type Description

Identity

Obligatoire

XdsGlobalRelativeIdentity

Cette valeur de chaîne identifie de manière unique le profil de stratégie de bande passante que vous voulez supprimer. Spécifier une identité supprimera, au maximum, un seul profil.

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.NetworkConfiguration.BWPolicyProfileType. Accepte la saisie de données des objets de profil de stratégie de bande passante réseau.

Types de retours

Cette cmdlet ne retourne aucune valeur. Elle supprime un objet du type Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.BWPolicyProfileType.

Exemple

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

Remove-CsNetworkBandwidthPolicyProfile -Identity LowBWProfile

Cet exemple supprime le profil de stratégie de bande passante avec l’identité LowBWProfile. Puisque les identités sont uniques, cette commande supprime au maximum un profil.

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

Get-CsNetworkSite | Where-Object {$_.BWPolicyProfileID -eq "LowBWProfile"} | Set-CsNetworkSite -BWPolicyProfileID $null
Remove-CsNetworkBandwidthPolicyProfile -Identity LowBWProfile

L’exemple 2 supprime de tous les sites toutes les références au profil de stratégie de bande passante auquel l’identité LowBWProfile a été affectée, puis supprime ce profil. La première ligne de cet exemple commence par appeler Get-CsNetworkSite pour récupérer tous les sites configurés pour le contrôle d’admission des appels (CAC). Cette collection de sites est ensuite redirigée vers Where-Object qui ne recherche que les sites avec une identité BWPolicyProfileID égale à (-eq) LowBWProfile. Cette collection filtrée qui ne contient que les sites avec une valeur BWPolicyProfileID définie sur LowBWProfile est redirigée vers Set-CSNetworkSite qui modifie chacun de ces sites pour modifier la valeur BWPolicyProfileID en lui donnant la valeur Null ($null). Ce que nous venons de faire consiste à trouver tous les sites avec une identité BWPolicyProfileID définie sur LowBWProfile et définir cette valeur sur Null. À ce stade, aucun site n’utilise le profil LowBWProfile, À présent, appelons la cmdlet Remove-CsNetworkBandwidthPolicyProfile sur le profil LowBWProfile afin de le supprimer, en sachant que ce profil n’est utilisé par aucun site.

Pour vérifier que ce profil n’est pas utilisé dans la configuration réseau, exécutez les étapes de la ligne 1 sur les stratégies intersites et les liens de région réseau.