Partager via

  • Article

Remove-CsStaticRoutingConfiguration

 

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

Supprime la collection spécifiée de paramètres de configuration du routage statique.

Syntaxe

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

Description détaillée

Lorsque vous envoyez un message SIP à quelqu’un, celui-ci devra peut-être transiter par plusieurs sous-réseaux et réseaux avant d’être remis. Le chemin parcouru par le message est souvent appelé « itinéraire ». En matière de réseau, il existe deux types d’itinéraires : dynamique et statique. Avec le routage dynamique, les serveurs utilisent des algorithmes afin de déterminer l’emplacement (ou tronçon) suivant vers lequel un message doit être transféré. Avec le routage statique, les chemins parcourus par les messages sont prédéfinis par les administrateurs système. Quand un message est reçu par un serveur, ce dernier vérifie son adresse, puis le transmet au tronçon suivant prédéfini par l’administrateur. S’ils sont configurés correctement, les itinéraires statiques contribuent à assurer une remise précise et en temps voulu des messages, tout en garantissant une charge minime sur les serveurs. Néanmoins, avec les itinéraires statiques, les messages ont l’inconvénient de ne pas être dynamiquement redirigés dans l’éventualité d’une défaillance du réseau.

Lorsque vous installez Microsoft Lync Server 2010, une collection globale d’itinéraires statiques est automatiquement créée pour vous. (La collection est créée, mais il n’existe pas d’itinéraires affectés à cette dernière.) En outre, le logiciel permet de créer d’autres collections appliquées au niveau de l’étendue Service (ces nouvelles collections ne pouvant être affectées qu’au service Serveur d’inscriptions). Si vous changez d’avis, vous pouvez utiliser la cmdlet Remove-CsStaticRoutingConfiguration pour supprimer les collections appliquées à l’étendue Service.

Vous pouvez également exécuter Remove-CsStaticRoutingConfiguration sur la collection globale. Dans ce cas, elle n’est pas supprimée, car Lync Server 2010 ne permet pas de supprimer les collections globales. En fait, les valeurs par défaut de toutes les propriétés dans la collection globale sont restaurées. Cela implique que tous les itinéraires affectés à la collection globale sont supprimés.

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

Paramètres

Paramètre Obligatoire Type Description

Identity

Obligatoire

XdsIdentity

Identificateur unique de la collection de configurations de routage statique à supprimer. Pour supprimer une collection configurée au niveau de l’étendue Service, utilisez la syntaxe suivante : -Identity "service:Registrar:atl-cs-001.litwareinc.com".

Vous pouvez également exécuter Remove-CsStaticRoutingConfiguration sur la collection globale. Pour ce faire, utilisez la syntaxe suivante : -Identity global. Toutefois, notez que la collection globale n’est pas réellement supprimée. Les propriétés de la collection seront en revanche réinitialisées à leurs valeurs par défaut. Cela signifie que tous les éléments de la propriété Route seront supprimés.

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.SipProxy.RoutingSettings. Remove-CsStaticRoutingConfiguration accepte les instances transmises via le pipeline de l’objet de paramètres du routage statique.

Types de retours

Remove-CsStaticRoutingConfiguration ne retourne aucune valeur ni aucun objet. Au lieu de cela, la cmdlet supprime les instances de l’objet Microsoft.Rtc.Management.WritableConfig.Settings.SipProxy.RoutingSettings.

Exemple

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

Remove-CsStaticRoutingConfiguration -Identity "service:Registrar:atl-cs-001.litwareinc.com"

La commande affichée dans l’exemple 1 supprime la collection de configuration du routage statique dotée de l’identité service:Registrar:atl-cs-001.litwareinc.com.

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

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

Dans l’exemple 2, toutes les collections de configurations de routage statique appliquées à l’étendue Service sont supprimées. Pour ce faire, la commande commence par utiliser Get-CsStaticRoutingConfiguration et le paramètre Filter. La valeur de filtre "service:*" limite les données retournées aux collections dont l’identité commence par la valeur de type chaîne "service:". Cette collection filtrée est alors redirigée vers Remove-CsStaticRoutingConfiguration qui supprime chaque élément contenu dans la collection.

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

Get-CsStaticRoutingConfiguration | Where-Object {$_.Route.Count -eq 0} | Remove-CsStaticRoutingConfiguration

L’exemple 3 montre comment supprimer toutes les collections de configurations de routage statique qui n’ont pas d’itinéraires Pour exécuter cette tâche, la commande appelle d’abord Get-CsStaticRoutingConfiguration qui retourne des informations sur toutes les collections de routage statique utilisées dans l’organisation. Cette collection est ensuite redirigée vers la cmdlet Where-Object qui sélectionne uniquement les collections où le nombre d’itinéraires (Route.Count) est égal à 0. Les informations filtrées sont ensuite redirigées vers Remove-CsStaticRoutingConfiguration qui supprime les collections n’ayant pas au moins un itinéraire.