Set-CsLisPort
Dernière rubrique modifiée : 2012-03-26
Crée un port LIS (Location Information Server, serveur d’informations d’emplacement), crée une association entre un port et un emplacement (crée un emplacement si cet emplacement n’existe pas) ou modifie un port existant et son emplacement associé. L’association entre un port et un emplacement est utilisée dans une implémentation Enhanced 9-1-1 (E9-1-1) Enterprise Voice pour indiquer à un opérateur des services d’urgence l’emplacement d’un appelant.
Syntaxe
Set-CsLisPort -ChassisID <String> -PortID <String> [-City <String>] [-CompanyName <String>] [-Confirm [<SwitchParameter>]] [-Country <String>] [-Description <String>] [-HouseNumber <String>] [-HouseNumberSuffix <String>] [-Location <String>] [-PortIDSubType <InterfaceAlias | InterfaceName | LocallyAssigned>] [-PostalCode <String>] [-PostDirectional <String>] [-PreDirectional <String>] [-State <String>] [-StreetName <String>] [-StreetSuffix <String>] [-WhatIf [<SwitchParameter>]]
Set-CsLisPort -ChassisID <String> -PortID <String> [-Confirm [<SwitchParameter>]] [-Description <String>] [-PortIDSubType <InterfaceAlias | InterfaceName | LocallyAssigned>] [-WhatIf [<SwitchParameter>]]
Set-CsLisPort -City <String> -CompanyName <String> -Country <String> -HouseNumber <String> -HouseNumberSuffix <String> -Location <String> -PostalCode <String> -PostDirectional <String> -PreDirectional <String> -State <String> -StreetName <String> -StreetSuffix <String> [-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 permet à l’administrateur de relier des emplacements physiques au port auquel le client est connecté.
La combinaison de ChassisID, PortID et de PortIDSubType produit un emplacement de port unique. Si vous entrez une combinaison de clés ChassisID/PortID/PortIDSubType qui existe déjà, cette cmdlet mettra à jour l’emplacement pour ce port à partir des paramètres d’emplacement fournis. Si la combinaison de clés n’existe pas, un nouvel emplacement de port sera créé.
Si un emplacement avec une adresse correspondant exactement aux paramètres d’adresse entrés ici (valeurs nulles comprises) n’existe pas dans la base de données d’emplacements, une nouvelle adresse sera créée à partir des paramètres entrés avec cette cmdlet. (Vous pouvez extraire une liste des emplacements en appelant la cmdlet Get-CsLisLocation.) La cmdlet Set-CsLisPort ne nécessite aucun paramètre d’emplacement, vous pouvez créer une entrée de port sans l’associer à un emplacement. Il est également possible de créer un emplacement non valide avec cette cmdlet. Un emplacement valide doit être constitué au minimum des paramètres Location, HouseNumber, StreetName, City, State et Country. Si vous ne fournissez pas tous ces paramètres, les appels que reçoit le port référencé peuvent ne pas contenir les informations requises par l’opérateur d’urgence (selon que des paramètres valides sont disponibles pour un commutateur, un sous-réseau ou un point d’accès sans fil pouvant être utilisés à la place des paramètres de port). Pour cette raison, il est recommandé de fournir le plus possible de paramètres d’emplacement précis.
Un des paramètres requis de cette cmdlet est ChassisID. ChassisID correspond à l’adresse MAC (Media Access Control) du commutateur réseau du port. Si ce commutateur n’existe pas dans la base de données d’emplacements, cette cmdlet le créera. Vous pouvez extraire les commutateurs existants en appelant la cmdlet Get-CsLisSwitch. N’oubliez pas que même si une nouvelle entrée de commutateur est créée, ce commutateur ne sera pas automatiquement associé aux informations d’emplacement entrées à l’aide de la cmdlet Set-CsLisPort ; par conséquent, vous devez définir l’emplacement du commutateur avec la cmdlet Set-CsLisSwitch.
Personnes autorisées à exécuter cette cmdlet : Par défaut, les membres des groupes qui suivent sont autorisés à exécuter localement la cmdlet Set-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 "Set-CsLisPort"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
ChassisID |
Obligatoire |
Chaîne |
Adresse MAC du commutateur du port. Cette valeur doit être indiquée sous la forme nn-nn-nn-nn-nn-nn, par exemple 12-34-56-78-90-ab, ou elle peut correspondre à une adresse IP. Si la combinaison de ChassisID, PortID et PortIDSubType est unique, un nouvel emplacement de port sera créé. Si cet emplacement n’est pas unique, l’emplacement du port avec cette combinaison de clés sera mis à jour avec les valeurs des paramètres fournis avec la commande. |
City |
Obligatoire |
Chaîne |
Ville de l’emplacement de ce port. Longueur maximale : 64 caractères. |
CompanyName |
Obligatoire |
Chaîne |
Nom de la société à cet emplacement. Longueur maximale : 60 caractères |
Country |
Obligatoire |
Chaîne |
Pays/région du port. Longueur maximale : 2 caractères |
Description |
Facultatif |
Chaîne |
Description détaillée de l’emplacement de ce port. |
HouseNumber |
Obligatoire |
Chaîne |
Numéro de la voie correspondant à l’emplacement du port. Pour les sociétés, il s’agit du numéro de la rue. Longueur maximale : 10 caractères |
HouseNumberSuffix |
Obligatoire |
Chaîne |
Informations supplémentaires sur le numéro de la voie (de type 1/2 ou A). Exemple : 1234 1/2 Oak Street ou 1234 A Elm Street. Remarque : pour désigner le numéro d’un bâtiment ou d’une suite de bureaux, vous devez utiliser le paramètre Location. Exemple : -Location "Suite 100/Office 150". Longueur maximale : 5 caractères |
Location |
Obligatoire |
Chaîne |
Nom de cet emplacement. En général, cette valeur correspond au nom d’un emplacement plus précis que l’adresse officielle, comme le numéro d’un bureau, mais il peut s’agir de n’importe quelle valeur de chaîne. Longueur maximale : 20 caractères |
PortID |
Obligatoire |
Chaîne |
ID du port associé à cet emplacement. |
PortIDSubType |
Facultatif |
PortIDSubType |
Sous-type du port. 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 Valeur par défaut : 7 (LocallyAssigned) |
PostalCode |
Obligatoire |
Chaîne |
Code postal associé à cet emplacement. Longueur maximale : 10 caractères |
PostDirectional |
Obligatoire |
Chaîne |
Orientation géographique d’un nom de rue. Exemple : NE (nord-est) ou NW (nord-ouest) pour la rue Main Street NE ou 7th Avenue NW. Longueur maximale : 2 caractères |
PreDirectional |
Obligatoire |
Chaîne |
Orientation géographique d’un nom de rue précédant le nom de la rue. Exemple : NE (nord-est) ou NW (nord-ouest) pour la rue NE Main Street ou NW 7th Avenue. Longueur maximale : 2 caractères |
State |
Obligatoire |
Chaîne |
État ou province associé(e) à cet emplacement. Longueur maximale : 2 caractères |
StreetName |
Obligatoire |
Chaîne |
Nom de la rue pour cet emplacement. Longueur maximale : 60 caractères |
StreetSuffix |
Obligatoire |
Chaîne |
Type d’artère désigné dans un nom (par exemple : rue, avenue ou boulevard). Longueur maximale : 10 caractères |
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 crée ou modifie un objet de type System.Management.Automation.PSCustomObject.
Exemple
-------------------------- Exemple 1 --------------------------
Set-CsLisPort -ChassisID 99-99-99-99-99-99 -PortID 4200 -PortIDSubType 1
L’exemple 1 crée ou met à jour une entrée d’emplacement de port LIS. La commande dans cet exemple comporte trois paramètres : ChassisID, PortID et PortIDSubtype. La valeur du paramètre ChassisID est l’adresse MAC, soit 99-99-99-99-99-99, la valeur du paramètre PortID est 4200 et la valeur du paramètre PortIDSubType est 1. (Notez que si 1 est la valeur de PortIDSubType, celle-ci correspond à InterfaceAlias. Ce paramètre et sa valeur peuvent également être saisis comme suit : -PortIDSubType InterfaceAlias.) Ces trois paramètres sont obligatoires pour créer une instance unique d’un emplacement de port.
Notez que cet exemple ne comporte pas d’informations d’adresse. Il est possible de créer une entrée de port sur le serveur d’informations d’emplacement sans l’associer à une adresse. Cependant, les appels d’urgence acheminés via ce port peuvent ne pas (selon les emplacements de sous-réseau ou de commutateur définis) contenir suffisamment d’informations pour que l’opérateur d’urgence puisse identifier un emplacement.
IMPORTANT : Si un emplacement de port LIS avec cette combinaison de clés existe déjà, il sera remplacé par les valeurs dans cette commande. Par conséquent, si ce port était associé à une adresse (un emplacement physique), cette association n’existerait plus, car cette commande ne comporte pas d’informations d’emplacement. L’emplacement existera toujours dans la base de données d’emplacements mais il ne sera pas associé à ce port.
-------------------------- Exemple 2 --------------------------
Set-CsLisPort -ChassisID 99-99-99-99-99-99 -PortID 4200 -PortIdSubType 1 -Location "30/1000" -HouseNumber 1234 -PreDirectional NE -StreetName First -StreetSuffix Avenue -City Redmond -State WA -Country US -PostalCode 99999
L’exemple 2 met à jour le port créé dans l’exemple 1 en ajoutant les informations d’adresse. Si l’adresse n’existe pas dans la base de données d’emplacements, cette cmdlet créera cet emplacement.
-------------------------- Exemple 3 --------------------------
$a = Get-CsLisPort | Where-Object {$_.ChassisID -eq "99-99-99-99-99-88"}
$a | Set-CsLisPort -Location "30/1000" -HouseNumber 1234 -StreetName First -StreetSuffix Avenue -City Redmond -State WA -Country US -PostalCode 99999
Cet exemple met à jour tous les emplacements définis pour les ports avec l’adresse MAC (ChassisID) 99-99-99-99-99-88. La première ligne de cet exemple commence avec un appel de la cmdlet Get-CsLisPort, qui extrait tous les ports définis dans le service LIS. Cette collection de ports est redirigée vers la cmdlet Where-Object, qui recherche tous les ports ayant un paramètre ChassisID égal (-eq) à 99-99-99-99-99-88. Les ports dont le paramètre ChassisID a la valeur 99-99-99-99-99-88 sont affectés à la variable $a.
Dans la seconde ligne de cet exemple, le contenu de la variable $a (les ports LIS dont le paramètre ChassisID a la valeur 99-99-99-99-99-88) est redirigé vers la cmdlet Set-CsLisPort. Cette cmdlet sélectionne alors chaque port et le met à jour avec les valeurs des paramètres spécifiés (Location, HouseNumber, StreetName, StreetSuffix, City, State, Country et PostalCode).