Set-CsLisSubnet
Dernière rubrique modifiée : 2012-03-27
Crée un sous-réseau LIS (Location Information Server), crée une association entre un sous-réseau et un emplacement (crée un emplacement si cet emplacement n’existe pas) ou modifie un sous-réseau existant et son emplacement associé. L’association entre un sous-réseau et un emplacement est utilisée dans le cadre d’une implémentation du système Enhanced 9-1-1 (E9-1-1) Enterprise Voice pour signaler l’emplacement d’un appelant à un opérateur des services d’urgence.
Syntaxe
Set-CsLisSubnet -Subnet <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-CsLisSubnet -Subnet <String> [-Confirm [<SwitchParameter>]] [-Description <String>] [-WhatIf [<SwitchParameter>]]
Set-CsLisSubnet -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 sous-réseau auquel le client est connecté.
Le paramètre Subnet est le seul paramètre requis pour cette cmdlet. Si vous entrez une valeur Subnet qui existe déjà, cette cmdlet mettra à jour l’emplacement pour ce sous-réseau à partir des paramètres d’emplacement fournis. Si le paramètre Subnet n’existe pas, un nouvel emplacement de sous-réseau est 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-CsLisSubnet ne nécessite aucun paramètre d’emplacement. Vous pouvez créer une entrée de sous-réseau 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 provenant du sous-réseau spécifié peuvent ne pas contenir les informations requises par l’opérateur des services d’urgence (selon si des paramètres valides sont disponibles pour un commutateur, un port ou un point d’accès sans fil pouvant être utilisés à la place des paramètres de sous-réseau). Pour cette raison, il est recommandé de fournir le plus possible de paramètres d’emplacement précis.
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-CsLisSubnet : 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-CsLisSubnet"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Subnet |
Obligatoire |
Chaîne |
Il s’agit de l’adresse IP du sous-réseau. Cette valeur doit être saisie comme une adresse IPv4 (chiffres séparés par des points, par exemple 192.0.2.0). |
City |
Facultatif |
Chaîne |
Ville à l’emplacement concerné. Longueur maximale : 64 caractères. |
CompanyName |
Facultatif |
Chaîne |
Nom de la société à cet emplacement. Longueur maximale : 60 caractères |
Country |
Facultatif |
Chaîne |
Pays/région de l’emplacement concerné. Longueur maximale : 2 caractères |
Description |
Facultatif |
Chaîne |
Description détaillée de cet emplacement de sous-réseau. |
HouseNumber |
Facultatif |
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 |
Facultatif |
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 |
Facultatif |
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 |
Facultatif |
Chaîne |
Code postal associé à cet emplacement. Longueur maximale : 10 caractères |
PostDirectional |
Facultatif |
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 |
Facultatif |
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 |
Facultatif |
Chaîne |
État ou province associé(e) à cet emplacement. Longueur maximale : 2 caractères |
StreetName |
Facultatif |
Chaîne |
Nom de la rue pour cet emplacement. Longueur maximale : 60 caractères |
StreetSuffix |
Facultatif |
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 sous-réseaux LIS.
Types de retours
Cette cmdlet crée ou modifie un objet de type System.Management.Automation.PSCustomObject.
Exemple
-------------------------- Exemple 1 --------------------------
Set-CsLisSubnet -Subnet 192.10.10.0
L’exemple 1 crée ou met à jour une entrée d’emplacement de sous-réseau LIS. La commande présentée dans cet exemple comprend un seul paramètre (obligatoire) : Subnet. La valeur du paramètre Subnet dans cet exemple est l’adresse IPv4 192.10.10.0.
Notez que cet exemple ne comporte pas d’informations d’adresse. Il est possible de créer une entrée de sous-réseau sur le serveur LIS sans l’associer à une adresse. Cependant, les appels d’urgence acheminés via ce sous-réseau peuvent ne pas contenir (selon les emplacements de port ou de commutateur définis) suffisamment d’informations pour que l’opérateur des services d’urgence puisse identifier un emplacement.
IMPORTANT : si un emplacement de sous-réseau de LIS contenant cette valeur Subnet existe déjà, il est remplacé par les valeurs de cette commande. Ainsi, si le sous-réseau était associé à une adresse (emplacement physique), cette association n’existerait plus car aucune information d’emplacement n’a été incluse dans la commande. L’emplacement existera toujours dans la base de données des emplacements, mais il ne sera pas associé à ce sous-réseau.