Partager via

  • Article

Set-CsLocationPolicy

 

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

Modifie une stratégie d’emplacement existante.

Syntaxe

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

Set-CsLocationPolicy [-ConferenceMode <Nullable>] [-ConferenceUri <String>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-EmergencyDialMask <String>] [-EmergencyDialString <String>] [-EnhancedEmergencyServicesEnabled <$true | $false>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-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 liés au système Enhanced 9-1-1 (E9-1-1) et à l’emplacement du client. 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 modifie une stratégie d’emplacement existante.

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-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 "Set-CsLocationPolicy"}

Paramètres

Paramètre Obligatoire Type Description

Identity

Facultatif

XdsIdentity

Identificateur unique de la stratégie d’emplacement que vous souhaitez modifier. Pour modifier la stratégie d’emplacement globale, utilisez la valeur Global. Pour une stratégie créée au niveau de l’étendue Site, cette valeur prend la forme site:<nom du site>, où le nom du site est celui défini dans le déploiement de Microsoft Lync Server 2010 (par exemple, site:Redmond). Pour une stratégie créée au niveau de l’étendue Utilisateur, cette valeur sera simplement le nom de la stratégie (par exemple, Reno).

Instance

Facultatif

LocationPolicy

Référence à un objet de stratégie d’emplacement. Cet objet doit être du type Microsoft.Rtc.Management.WritableConfig.Policy.Location.LocationPolicy, qui peut être extrait en appelant la cmdlet Get-CsLocationPolicy. Récupérez cet objet, modifiez les propriétés en mémoire, puis transmettez la référence d’objet comme valeur à ce paramètre pour mettre à jour cette stratégie d’emplacement.

ConferenceMode

Facultatif

ConferenceModeEnum

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

- oneway : le tiers peut uniquement écouter la conversation entre l’appelant et l’opérateur du centre d’appels de la sécurité publique (PSAP).

- twoway : 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

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é, et 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, « Building 30, 3rd Floor, NorthEast corner ».

EmergencyDialMask

Facultatif

Chaîne

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

IMPORTANT. Assurez-vous que la valeur du masque d’appel n’est pas identique à un numéro figurant dans une plage d’orbites de mise en garde d’appels. Le routage de mise en garde d’appels aura priorité sur la conversion des chaînes d’appel d’urgence. Pour afficher les plages d’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 qui est 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 caractères.

EnhancedEmergencyServicesEnabled

Facultatif

Booléen

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

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 (PSAP, soit l’opérateur des services d’urgence).

- 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 des informations sur l’emplacement (cette notification doit être définie en appelant la cmdlet Set-CsEnhancedEmergencyServiceDisclaimer).

Cette valeur est ignorée si EnhancedEmergencyServicesEnabled est définie 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 (Uniform Resource Identifier) 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, cet emplacement sera inclus dans la notification.

Plusieurs URI SIP peuvent être insérés dans une liste séparée par des virgules. Par exemple, -NotificationUri sip:security@litwareinc.com,sip:kmyer@litwareinc.com. Gardez à l’esprit que les listes de distribution et les URI des groupes 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 PSTN (réseau téléphonique commuté) qui sera utilisée pour déterminer l’itinéraire de communications vocales qui permettra d’acheminer les appels d’urgence des 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à figurer dans la liste globale des utilisations PSTN. Appelez la cmdlet Get-CsPstnUsage pour extraire une liste des utilisations. Pour créer une 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 (notamment pour informer des collègues de travail sur 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.

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

Objet Microsoft.Rtc.Management.WritableConfig.Policy.Location.LocationPolicy. Accepte la saisie de données transmises via le pipeline pour les objets de stratégie d’emplacement.

Types de retours

Cette cmdlet ne retourne ni valeur, ni objet. Au lieu de cela, la cmdlet configure des instances de l’objet Microsoft.Rtc.Management.WritableConfig.Policy.Location.LocationPolicy.

Exemple

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

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

Cette commande utilise la cmdlet Set-CsLocationPolicy pour modifier la stratégie d’emplacement avec l’identité site:Redmond. (En d’autres termes, elle modifie la stratégie d’emplacement appliquée au site Redmond.) Dans ce cas, la commande définit la valeur de la propriété EnhancedEmergencyServicesEnabled sur True, ce qui activera la fonctionnalité E9-1-1 pour tous les utilisateurs connectés (dans ce cas) au site Redmond.

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

Get-CsLocationPolicy | Where-Object {$_.ConferenceUri -ne $null} | Set-CsLocationPolicy -ConferenceMode twoway

L’exemple 2 modifie toutes les stratégies d’emplacement utilisées dans l’organisation pour lesquelles un URI de conférence est défini en vue d’une conférence bidirectionnelle. Pour exécuter cette tâche, la commande utilise d’abord la cmdlet Get-CsLocationPolicy pour retourner une collection de toutes les stratégies d’emplacement actuellement utilisées. Cette collection est ensuite redirigée vers la cmdlet Where-Object pour restreindre la collection aux stratégies d’emplacement dont la propriété ConferenceUri n’est pas vide (non égale à Null). Il en résulte une collection de stratégies d’emplacement dotées de valeurs ConferenceUri. Cette collection est ensuite redirigée vers Set-CsLocationPolicy qui modifie la valeur de la propriété ConferenceMode pour chaque stratégie de la collection en définissant la valeur sur « twoway ».