Partager via

  • Article

New-CsLocationPolicy

 

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

Crée une nouvelle stratégie d’emplacement en vue de l’utiliser avec l’identification de l’emplacement du service et du client général Enhanced 9-1-1 (E9-1-1). Le service E9-1-1 permet à ceux qui répondent à des appels d’urgence de déterminer l’emplacement géographique de l’appelant.

Syntaxe

New-CsLocationPolicy -Identity <XdsIdentity> [-ConferenceMode <Nullable>] [-ConferenceUri <String>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-EmergencyDialMask <String>] [-EmergencyDialString <String>] [-EnhancedEmergencyServicesEnabled <$true | $false>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-LocationRequired <Nullable>] [-NotificationUri <String>] [-PstnUsage <String>] [-UseLocationForE911Only <Nullable>] [-WhatIf [<SwitchParameter>]]

Description détaillée

La stratégie d’emplacement est utilisée pour appliquer des paramètres relatifs à la fonctionnalité E9-1-1 et des paramètres d’emplacement aux utilisateurs ou aux contacts. La stratégie d’emplacement détermine si un utilisateur peut avoir recours au système E9-1-1 et, le cas échéant, quel est le comportement d’un appel d’urgence. Par exemple, la stratégie d’emplacement permet de définir le numéro d’appel d’urgence (911 aux États-Unis), de déterminer si le service de sécurité de l’entreprise doit être automatiquement averti et comment l’appel doit être acheminé. Cette cmdlet crée une nouvelle stratégie d’emplacement dans l’étendue site ou utilisateur (une stratégie existe déjà dans l’étendue globale).

IMPORTANT : la stratégie d’emplacement a un comportement différent des autres stratégies dans Lync Server 2010 en termes d’ordre d’application selon l’étendue . Pour toutes les autres stratégies, si une stratégie est définie au niveau de l’étendue Utilisateur, elle sera appliquée à tout utilisateur ayant reçu cette stratégie. Si aucune stratégie utilisateur n'a été octroyée à l'utilisateur, la stratégie de site est appliquée. Si aucune stratégie de site n’existe, la stratégie globale est appliquée. Les stratégies d'emplacement sont appliquées de la même façon à une exception : une stratégie d'emplacement utilisateur peut également être affectée à un site réseau. (Un site réseau est un groupe de sous-réseaux.) Si l'utilisateur effectue l'appel d'urgence depuis un emplacement mappé à un site réseau au sein de l'organisation, la stratégie pour le site réseau est utilisée. Cette fonctionnalité remplacera une stratégie utilisateur qui a été octroyée à cet utilisateur. Si l’utilisateur appelle d’un emplacement inconnu ou non mappé dans l’organisation, la stratégie standard sera appliquée.

Personnes autorisées à exécuter cette cmdlet : Par défaut, les membres des groupes qui suivent sont autorisés à exécuter localement la cmdlet New-CsLocationPolicy : 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 "New-CsLocationPolicy"}

Paramètres

Paramètre Obligatoire Type Description

Identity

Facultatif

XdsIdentity

Identificateur unique de la stratégie d’emplacement. Cette cmdlet peut être utilisée pour créer des stratégies dans l’étendue Site ou Utilisateur. (Il existe une stratégie globale par défaut qui ne peut pas être supprimée.) Dans le cas d’une stratégie crée dans l’étendue Site, cette valeur doit être au format suivant :<nom du site>, où nom du site correspond au nom d’un site défini dans le déploiement de Microsoft Lync Server 2010. Par exemple : site:Redmond. Une stratégie créée dans l’étendue utilisateur peut être affectée à n’importe quelle valeur de chaîne, telle que Reno.

ConferenceMode

Facultatif

ConferenceModeEnum

Si une valeur est spécifiée pour le paramètre ConferenceUri, le paramètre ConferenceMode détermine si le tiers peut participer à l’appel ou uniquement l’écouter. Les valeurs disponibles sont :

- unilatéral : le tiers peut uniquement écouter la conversation entre l’appelant et l’opérateur du centre d’appels de la sécurité publique (Public Safety Answering Point ou PSAP).

- bilatéral : le tiers peut écouter et participer à l’appel entre l’appelant et l’opérateur du centre d’appels de la sécurité publique.

ConferenceUri

Facultatif

Chaîne

L’URI (Uniform Resource Identifier) SIP, dans ce cas, le numéro de téléphone, d’un tiers qui sera invité à participer à tous les appels d’urgence effectués. Par exemple, le service de sécurité de la société peut prendre un appel lorsqu’un appel d’urgence est effectué, l’écouter ou y participer (en fonction de la valeur de la propriété ConferenceMode).

La chaîne doit comporter entre 1 et 256 caractères et commencer par le préfixe sip:.

Description

Facultatif

Chaîne

Description détaillée de cet emplacement. Par exemple : « Utilisateurs d’entreprise de Reno ».

EmergencyDialMask

Facultatif

Chaîne

Numéro composé qui sera converti en valeur de la propriété EmergencyDialString. Par exemple, si EmergencyDialMask a une valeur de « 212 » et EmergencyDialString a une valeur de « 911 », si un utilisateur compose le 212, l'appel sera passé au 911. Cela permet de composer d’autres numéros d’urgence tout en ayant la possibilité de joindre les services d’urgence (par exemple : une personne provenant d’un pays doté d’un numéro d’urgence différent essaie de composer ce numéro au lieu du numéro du pays dans lequel elle se trouve actuellement). Vous pouvez définir plusieurs masques d'appel d'urgence en séparant les valeurs par des points virgule. Par exemple, -EmergencyDialMask « 212;414 ».

IMPORTANT : assurez-vous que la valeur spécifiée pour ce masque ne correspond pas à un numéro dans une plage des orbites de mise en garde d’appels. L'acheminement d'une mise en garde d'appels sera prioritaire sur une conversion de numérotation d'urgence. Pour voir les plages des orbites de mise en garde d'appels, appelez la cmdlet Get-CsCallParkOrbit.

La longueur maximale de la chaîne est de 100 caractères. Chaque caractère doit être un chiffre compris entre 0 et 9.

EmergencyDialString

Facultatif

Chaîne

Numéro composé pour joindre les services d’urgence. Aux États-Unis, cette valeur est 911.

La chaîne doit être composée des chiffres 0 à 9 et peut avoir une longueur comprise entre 1 et 10 chiffres.

EnhancedEmergencyServicesEnabled

Obligatoire

Booléen

Indique si les utilisateurs associés à cette stratégie sont activés pour E9-1-1. Définissez la valeur sur True pour activer E9-1-1. De cette manière, les clients Lync Server 2010 extrairont les informations sur l’emplacement lors de l’inscription et incluront ces dernières lors d’un appel d’urgence.

Valeur par défaut : False

LocationRequired

Facultatif

LocationRequiredEnum

Si le client ne parvient pas à extraire un emplacement de la base de données de configuration des emplacements, l’utilisateur peut être invité à saisir manuellement un emplacement. Ce paramètre accepte les valeurs suivantes :

- no : l’utilisateur n’est pas invité à saisir un emplacement. Lorsqu’un appel est effectué sans informations sur l’emplacement, le fournisseur de services d’urgence y répond et demande qu’un emplacement lui soit indiqué.

- yes : l’utilisateur est invité à fournir des informations sur l’emplacement lorsque le client s’inscrit à un nouvel emplacement. L’utilisateur peut ignorer l’invite sans saisir aucune information. S’il saisit des informations, l’appel des services d’urgence sera d’abord pris par le fournisseur de services d’urgence pour vérifier l’emplacement avant d’être acheminé vers le centre d’appels de la sécurité publique (Public Safety Answering Point ou PSAP).

- disclaimer : cette option équivaut à une réponse positive, mais si l’utilisateur ignore l’invite, un texte d’exclusion s’affiche pour l’informer des conséquences du refus de saisir les informations d’emplacement (cette notification doit être définie en appelant la cmdlet Set-CsEnhancedEmergencyServiceDisclaimer).

Cette valeur est ignorée si EnhancedEmergencyServicesEnabled est défini sur False (valeur par défaut). Aucune invite de saisie des informations sur l’emplacement ne s’affiche.

NotificationUri

Facultatif

Chaîne

Un ou plusieurs URI SIP à notifier lorsqu’un appel d’urgence est établi. Par exemple, le service de sécurité de la société peut être informé via un message instantané chaque fois qu’un appel d’urgence est effectué. Si l'emplacement de l'appelant est disponible, celui-ci sera inclus dans la notification.

Plusieurs URI SIP peuvent être inclus sous la forme d'une liste de valeurs séparées par des virgules. Par exemple, -NotificationUri sip:security@litwareinc.com,sip:kmyer@litwareinc.com. N'oubliez pas que les listes de distribution et les URI de groupe ne sont pas pris en charge.

La chaîne doit comporter entre 1 et 256 caractères et commencer par le préfixe sip:.

PstnUsage

Facultatif

Chaîne

Utilisation du réseau téléphonique commuté (PSTN) qui sera utilisée pour déterminer l’itinéraire de communications vocales qui permettra d’acheminer les appels d’urgence de clients à l’aide de ce profil. L’itinéraire associé à cette utilisation doit pointer sur un tronçon SIP dédié aux appels d’urgence.

L'utilisation doit déjà exister dans la liste globale des utilisations PSTN. Appelez la cmdlet Get-CsPstnUsage pour récupérer la liste des utilisations. Pour créer une nouvelle utilisation, appelez la cmdlet Set-CsPstnUsage.

UseLocationForE911Only

Facultatif

Booléen

Les informations sur l’emplacement peuvent être utilisées par le client Microsoft Lync 2010 pour plusieurs raisons (comme par exemple, informer des collègues à propos de l’emplacement actuel). Définissez cette valeur sur True pour vous assurer que les informations sur l’emplacement sont uniquement disponibles lors d’un appel d’urgence.

Force

Facultatif

Paramètre de commutateur

Supprime les invites de confirmation qui s’affichent avant d’effectuer des modifications.

InMemory

Facultatif

Paramètre de commutateur

Crée une référence d’objet sans valider l’objet comme une modification définitive. Si vous affectez à une variable la sortie de cette cmdlet appelée avec ce paramètre, vous pouvez apporter des modifications aux propriétés de la référence d’objet, puis les valider en appelant la cmdlet Set- correspondante.

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

Aucun.

Types de retours

Crée un objet de type Microsoft.Rtc.Management.WritableConfig.Policy.Location.LocationPolicy.

Exemple

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

New-CsLocationPolicy -Identity site:Redmond -EnhancedEmergencyServicesEnabled $True

Dans l’exemple 1, on utilise la cmdlet New-CsLocationPolicy pour créer une nouvelle stratégie d’emplacement pour le site de Redmond qui active tous les utilisateurs sur ce site pour E9-1-1. Pour créer cette stratégie, la cmdlet New-CsLocationPolicy est appelée avec deux paramètres : un paramètre pour définir l’identité, qui représente dans ce cas la chaîne site: suivi du nom du site auquel cette stratégie s’appliquera, un autre pour définir la valeur de la propriété EnhancedEmergencyServicesEnabled sur True.

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

New-CsLocationPolicy -Identity Reno -Description "All users located at the Reno site" -EnhancedEmergencyServicesEnabled $True -PstnUsage Emergency -EmergencyDialString 911

Cet exemple illustre la création d’une stratégie d’emplacement utilisateur (les stratégies utilisateur doivent être spécialement définies pour des utilisateurs individuels ou des groupes). Cette stratégie comporte l’identité Reno. Nous avons ajouté une description plus détaillée de la stratégie à l’aide du paramètre Description. Le paramètre suivant fourni est EnhancedEmergencyServicesEnabled, qui est défini sur True afin d’activer la fonctionnalité E9-1-1 pour tous les utilisateurs auxquels cette stratégie est accordée. Le paramètre suivant est PstnUsage, dans ce cas avec la valeur Emergency. Cette valeur doit correspondre à une valeur figurant dans la liste des utilisations PSTN (vous pouvez extraire cette liste en appelant la cmdlet Get-CsPstnUsage). L’utilisation doit être associée à un itinéraire de communications vocales qui sera utilisé pour les appels d’urgence (vous pouvez extraire des itinéraires de communications vocales en appelant la cmdlet Get-CsVoiceRoute). Le dernier paramètre utilisé dans cet exemple est EmergencyDialString, qui spécifie le numéro composé indiquant un appel d’urgence.