Partager via

  • Article

Set-CsLisLocation

 

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

Crée un nouvel emplacement ou modifie un emplacement existant dans la base de données de configuration des emplacements pour le système Enhanced 9-1-1 (E9-1-1).

Syntaxe

Set-CsLisLocation -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>]]

Set-CsLisLocation -Instance <PSObject> [-City <String>] [-CompanyName <String>] [-Confirm [<SwitchParameter>]] [-Country <String>] [-HouseNumber <String>] [-HouseNumberSuffix <String>] [-Location <String>] [-PostalCode <String>] [-PostDirectional <String>] [-PreDirectional <String>] [-State <String>] [-StreetName <String>] [-StreetSuffix <String>] [-WhatIf [<SwitchParameter>]]

Description détaillée

Le système E9-1-1 permet à des personnes répondant aux appels d’urgence de déterminer la position géographique de l’appelant sans devoir lui demander cette information. Dans Microsoft Lync Server 2010, l’emplacement est déterminé en mappant le port, le sous-réseau, le commutateur ou le point d’accès sans fil de l’appelant à un emplacement spécifique. (Cette carte est nommée « schéma de câblage ».) Cette cmdlet ajoute une nouvelle adresse ou modifie une adresse existante dans la liste des emplacements stockés dans la base de données de configuration des emplacements sur le serveur LIS (Location Information Server). Ces emplacements sont ensuite rapprochés d’une liste d’adresses valides mises à disposition par le fournisseur de services d’urgence travaillant pour la société.

La combinaison de tous les paramètres requis pour cette cmdlet (autre que l’instance) constitue une entrée unique. Le fait de modifier l’un de ces paramètres crée un nouvel emplacement (et ne modifie pas l’emplacement existant). Notez que bien que tous ces paramètres soient requis, certains peuvent contenir des valeurs nulles. Les paramètres devant contenir des valeurs non nulles sont : Location, HouseNumber, StreetName, City, State et Country. Pour modifier une valeur existante, vous devez utiliser le paramètre Instance (ou rediriger une instance vers la cmdlet).

Cette cmdlet est ainsi utilisée pour créer un emplacement. Un emplacement est également créé automatiquement quand une nouvelle adresse est entrée pour un port, un sous-réseau, un commutateur ou un point d’accès sans fil. Ces informations peuvent être entrées à l’aide des cmdlets Set-CsLisPort, Set-CsLisSubnet, Set-CsLisSwitch et Set-CsLisWirelessAccessPoint.

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

Paramètres

Paramètre Obligatoire Type Description

Instance

Obligatoire

PSObject

Référence à un objet d’emplacement. Cet objet doit contenir les propriétés requises pour créer un emplacement. Vous pouvez récupérer un objet de ce type en appelant Get-CsLisLocation.

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

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 d’emplacement LIS.

Types de retours

Cette cmdlet ne retourne aucune valeur ni objet. Elle crée ou modifie un objet de type System.Management.Automation.PSCustomObject.

Exemple

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

Set-CsLisLocation -Location Bldg30NEWing -HouseNumber 1000 -StreetName Main -City Redmond -State WA -Country US

L’exemple 1 crée un nouvel emplacement nommé Bldg30NEWing. Cette commande complète tous les paramètres requis pour la création des valeurs d’emplacement. Dans cet exemple, l’adresse de l’emplacement est 1000 Main, Redmond, WA, US. Cette adresse est entrée en spécifiant la valeur 1000 pour le paramètre HouseNumber ; la valeur Main pour le paramètre StreetName ; la valeur Redmond pour le paramètre City ; et la valeur US pour le paramètre Country.

Notez que si vous exécutez une commande avec les paramètres affichés ici, vous serez invité à entrer davantage de paramètres. Vous pouvez toutefois simplement appuyer sur la touche Entrée à chaque invite sans fournir de valeurs et votre emplacement sera tout de même créé.

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

Set-CsLisLocation -Location "Suite 100/Office 20" -CompanyName "Litware, Inc." -HouseNumber 1234 -HouseNumberSuffix "" -PreDirectional "" -StreetName Main -StreetSuffix St -PostDirectional "" -City Redmond -State WA -PostalCode 99999 -Country US

Cet exemple est similaire à l’exemple 1, en ce qu’il crée un nouvel emplacement. Dans cet exemple toutefois, la commande spécifie tous les paramètres de la cmdlet. Cela évite l’affichage des invites qui suivent la commande de l’exemple 1, car cet exemple définit simplement les valeurs que nous souhaitons laisser vierges par des chaînes vides.

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

$a = Get-CsLisLocation | Where-Object {$_.Location -ceq "Bldg30NEWing"}
Set-CsLisLocation -Instance $a -StreetSuffix Street

Cet exemple modifie l’emplacement créé dans l’exemple 1. La première ligne de l’exemple commence par l’appel de la cmdlet Get-CsLisLocation. Cette action retourne une collection de tous les emplacements définis au sein du déploiement Lync Server 2010. Cette collection est ensuite redirigée vers la cmdlet Where-Object. Where-Object récupère tous les éléments de la collection dont la propriété Location est égale (-ceq, sensible à la casse) à Bldg30NEWing. L’objet correspondant à ces critères est attribué à la variable $a.

À la ligne 2, nous appelons Set-CsLisLocation. Le premier paramètre est Instance. Nous transmettons à ce paramètre la variable ($a) contenant l’objet récupéré à la ligne 1, qui est en fait l’objet que nous souhaitons modifier. Nous spécifions ensuite le paramètre StreetSuffix, en lui transmettant une valeur pour Street. Cela modifie la valeur de la propriété StreetSuffix de l’emplacement dans la variable $a, qui devient alors Street.

Notez que Location n’étant pas une propriété unique, la cmdlet Where-Object peut retourner plusieurs emplacements. Si tel est le cas, cet exemple n’est pas valide. Pour modifier plusieurs emplacements en une seule fois, voir l’exemple 4.

-------------------------- Exemple 4 --------------------------

$a = Get-CsLisLocation | Where-Object {$_.Location -ceq "NorthCampus"}
$a | Set-CsLisLocation -StreetSuffix Avenue

L’exemple 4 modifie la propriété StreetSuffix d’un ou plusieurs objets d’emplacement. Cet exemple commence un peu comme l’exemple 3. Nous commençons par appeler Get-CsLisLocation afin de récupérer tous les emplacements. Nous redirigeons ensuite cette collection d’emplacements vers Where-Object, ce qui restreint la collection aux emplacements dont la propriété Location est égale à NorthCampus. Cette nouvelle collection est stockée dans la variable $a. À la ligne 2, nous redirigeons le contenu de $a vers la cmdlet Set-CsLisLocation. Cette cmdlet passe en revue chaque objet (chaque emplacement) stocké dans $a et le modifie. Dans ce cas, la propriété StreetSuffix de chaque objet est modifiée en Avenue.

Les commandes de cet exemple peuvent également être accomplies sans utiliser de variable. Il suffit de rediriger les résultats de la cmdlet Where-Object vers la cmdlet Set-CsLisLocation de la façon suivante :

Get-CsLisLocation | Where-Object {$_.Location -ceq "NorthCampus"} | Set-CsLisLocation -StreetSuffix Avenue