Partager via


Set-CsLisSwitch

 

Dernière rubrique modifiée : 2012-04-23

Crée un commutateur LIS (Location Information Server), une association entre un commutateur et un emplacement (création d’un nouvel emplacement si celui-ci n’existe pas) ou modifie un commutateur existant et son emplacement associé. L’association entre un commutateur 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-CsLisSwitch -ChassisID <String> [-City <String>] [-CompanyName <String>] [-Confirm [<SwitchParameter>]] [-Country <String>] [-Description <String>] [-HouseNumber <String>] [-HouseNumberSuffix <String>] [-Location <String>] [-PostalCode <String>] [-PostDirectional <String>] [-PreDirectional <String>] [-State <String>] [-StreetName <String>] [-StreetSuffix <String>] [-WhatIf [<SwitchParameter>]]

Set-CsLisSwitch -ChassisID <String> [-Confirm [<SwitchParameter>]] [-Description <String>] [-WhatIf [<SwitchParameter>]]

Set-CsLisSwitch -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 commutateur réseau par lequel le client est connecté.

Le paramètre ChassisID est le seul paramètre requis pour cette cmdlet. Si vous entrez une valeur ChassisID qui existe déjà, cette cmdlet mettra à jour l’emplacement pour ce commutateur à partir des paramètres d’emplacement fournis. Si la valeur ChassisID est inexistante, un nouvel emplacement sera créé pour le commutateur.

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-CsLisSwitch ne nécessite aucun paramètre d’emplacement, vous pouvez créer une entrée de commutateur 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 commutateur référencé peuvent ne pas contenir les informations requises par l’opérateur des services d’urgence (selon que des paramètres valides sont disponibles pour un sous-réseau ou un point d’accès sans fil pouvant être utilisés à la place des paramètres de commutateur). Pour cette raison, il est recommandé de fournir le plus possible de paramètres d’emplacement précis.

Notez que des entrées de commutateur peuvent également être créées à l’aide de la cmdlet Set-CsLisPort. Si vous appelez la cmdlet Set-CsLisPort avec une valeur ChassisID pour laquelle aucune entrée de commutateur n’existe, ce commutateur sera créé.

Il est important de noter que ces changements prendront effet seulement si vous avez configuré la propriété MACResolverUrl à l’aide de la cmdlet New-CsWebServiceConfiguration ou Set-CsWebServiceConfiguration. La propriété MACResolverUrl spécifie l’URL d’un service Web qui est capable de prendre une adresse IP et de déterminer l’adresse MAC (Media Access Control) de la carte réseau associée à cette adresse IP.

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

Paramètres

Paramètre Obligatoire Type Description

ChassisID

Obligatoire

Chaîne

L’adresse MAC (Media Access Control) du commutateur de réseau. Cette valeur doit être indiquée sous la forme nn-nn-nn-nn-nn-nn (par exemple, 12-34-56-78-90-ab) ou sous la forme d’une adresse IP. Si aucune entrée dotée de la valeur ChassisID spécifiée n’existe, un nouvel emplacement sera créé pour le commutateur. Si une entrée avec la valeur ChassisID existe, cette entrée sera remplacée.

City

Obligatoire

Chaîne

Ville à l’emplacement concerné.

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 de l’emplacement concerné.

Longueur maximale : 2 caractères

Description

Facultatif

Chaîne

Description détaillée de l’emplacement de ce commutateur réseau.

HouseNumber

Obligatoire

Chaîne

Numéro de la voie correspondant à l’emplacement. 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

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 commutateur LIS.

Types de retours

Cette cmdlet crée ou modifie un objet de type System.Management.Automation.PSCustomObject.

Exemple

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

Set-CsLisSwitch -ChassisID 99-99-99-99-99-99

L’exemple 1 crée ou met à jour une entrée d’emplacement de commutateur réseau LIS. La commande présentée dans cet exemple comprend un seul paramètre (obligatoire) : ChassisID. La valeur du paramètre ChassisID correspond à l’adresse MAC du commutateur, soit dans le cas présent 99-99-99-99-99-99.

Notez que cet exemple ne comporte pas d’informations d’adresse. Il est possible de créer une entrée de commutateur sur le serveur d’informations d’emplacement (LIS) sans l’associer à une adresse. Cependant, les appels d’urgence acheminés via ce commutateur peuvent ne pas contenir (selon les emplacements de sous-réseau ou de port définis) suffisamment d’informations pour que l’opérateur des services d’urgence puisse identifier un emplacement.

IMPORTANT : Si un emplacement de commutateur LIS avec cette valeur ChassisID existe déjà, il sera remplacé par les valeurs dans cette commande. Par conséquent, si ce commutateur é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 commutateur.

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

Set-CsLisSwitch -ChassisID 99-99-99-99-99-99 -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 commutateur créé dans l’exemple 1 en ajoutant les informations d’adresse. (Il s’agit en fait de supprimer l’entrée existante et de la remplacer par cette nouvelle entrée.) Si l’adresse n’existe pas dans la base de données d’emplacements, cette cmdlet créera cet emplacement.