Remove-CsLisPort
Dernière rubrique modifiée : 2012-03-27
Supprime une association entre un port LIS (Location Information Server) et un emplacement. Cette association est utilisée dans un système Enhanced 9-1-1 (E9-1-1) Enterprise Voice mis en place pour signaler l’emplacement d’un appelant à un opérateur des services d’urgence.
Syntaxe
Remove-CsLisPort -ChassisID <String> -PortID <String> -PortIDSubType <InterfaceAlias | InterfaceName | LocallyAssigned> [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]]
Description détaillée
Le système Enhanced 9-1-1 permet à un opérateur des services d’urgence d’identifier l’emplacement d’un appelant sans avoir à le lui demander. Dans le cas où un appelant appelle à partir d’une connexion VoIP, ces informations doivent être extraites en fonction de divers facteurs de connexion. L’administrateur VoIP doit configurer et établir un mappage d’emplacements (appelée « schéma de câblage ») qui déterminera l’emplacement d’un appelant. Cette cmdlet supprime une association entre un emplacement physique et un port via lequel les appels seront routés en supprimant le port de la base de données de configuration d’emplacements.
La suppression de l’emplacement d’un port ne supprimera pas l’emplacement réel du port ; seul le port est supprimé. Pour supprimer l’emplacement, appelez la cmdlet Remove-CsLisLocation. La suppression du port ne supprimera pas pour autant le commutateur avec un ID ChassisID donné. Pour supprimer le commutateur, appelez la cmdlet Remove-CsLisSwitch.
Si vous tentez de supprimer un port qui n’existe pas, aucune action ne sera entreprise et vous ne recevrez aucun message d’erreur ou d’avertissement.
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-CsLisPort : 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-CsLisPort"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
ChassisID |
Obligatoire |
Chaîne |
Adresse MAC (Media Access Control) du commutateur du port. Cette valeur sera exprimée sous la forme nn-nn-nn-nn-nn-nn (par exemple : 12-34-56-78-90-ab). |
PortID |
Obligatoire |
Chaîne |
ID du port à supprimer. |
PortIDSubType |
Obligatoire |
PortIDSubType |
Sous-type du port à supprimer. Cette valeur peut être saisie sous la forme d’une valeur numérique ou d’une chaîne mais elle doit être un sous-type valide. Les sous-types valides sont les suivants : 1: InterfaceAlias 5: InterfaceName 7: LocallyAssigned |
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
Accepte la saisie de données transmises via le pipeline pour les objets de port LIS.
Types de retours
Cette cmdlet ne retourne aucune valeur. Elle supprime un objet de type System.Management.Automation.PSCustomObject.
Exemple
-------------------------- Exemple 1 --------------------------
Remove-CsLisPort -ChassisID 99-99-99-99-99-99 -PortID 4200 -PortIDSubType 1
L’exemple 1 supprime le port LIS doté de l’adresse MAC (ChassisID) 99-99-99-99-99-99, dont PortID a la valeur 4200 et PortIDSubType la valeur 1. (Notez qu’une valeur égale à 1 pour PortIDSubType équivaut à une valeur InterfaceAlias. Ce paramètre et sa valeur peuvent également être saisis comme suit : -PortIDSubType InterfaceAlias)
Si ce port était associé à un emplacement, ce dernier ne sera pas supprimé, seul le port sera supprimé du mappage avec l’emplacement.
-------------------------- Exemple 2 --------------------------
Get-CsLisPort | Where-Object {$_.HouseNumber -eq ""} | Remove-CsLisPort
Cet exemple supprime tous les emplacements de port qui ne sont dotés d’aucun numéro de voie. L’exemple débute par un appel de la cmdlet Get-CsLisPort qui retourne une collection contenant tous les ports LIS. Cette collection est redirigée vers la cmdlet Where-Object qui y recherche les éléments dont la propriété HouseNumber est vide, à savoir tous les éléments où la propriété HouseNumber est égale à (-eq) une chaîne vide (“”). Enfin, nous redirigeons cette collection d’emplacements de port sans numéros de voie vers la cmdlet Remove-CsLisPort qui supprime tout au sein de cette collection.
Vous constaterez que, dans l’exemple 1, aucun emplacement n’est supprimé de la base de données de configuration d’emplacements. Seuls les ports se rapportant à ces emplacements le sont. Dans ce cas, cela signifie que certains emplacements dans la base de données ne seront pas valides (ils ne le sont pas parce que la propriété HouseNumber est obligatoire dans le cadre d’un emplacement) et qu’ils devront également être supprimés. Pour supprimer des emplacements, appelez la cmdlet Remove-CsLisLocation.