Set-CsLisServiceProvider
Dernière rubrique modifiée : 2012-03-27
Crée ou modifie des informations sur le service Web fourni par le fournisseur de routage de réseau Enhanced 9-1-1 (E9-1-1) pour vérifier les emplacements.
Syntaxe
Set-CsLisServiceProvider -CertFileName <String> -Password <SecureString> -ServiceProviderName <String> -ValidationServiceUrl <String> [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]]
Description détaillée
Dans une implémentation Enterprise Voice avec le système E9-1-1, les appels d’urgence doivent d’abord être routés via un fournisseur de routage réseau E9-1-1 afin de garantir le routage des appels vers le centre téléphonique de sécurité publique (Public Safety Answering Point, ou PSAP) concerné. (Un centre d’appels de la sécurité publique est l’agence chargée aux États-Unis de diriger les appels vers les services d’urgence les plus proches, comme la police, les pompiers ou le SAMU.) Pour cela, le fournisseur doit disposer d’une liste des emplacements de l’organisation, qu’il peut ensuite faire concorder avec la base de données MSAG (Master Street Address Guide) pour vérifier que tous les emplacements sont valides. Cette cmdlet crée ou modifie les informations sur un fournisseur, y compris son nom, une URL pour le service Web que l’organisation utilise pour transmettre les emplacements, ainsi qu’un certificat et un mot de passe pour le service Web sécurisé.
Vous ne pouvez pas définir plus d’un fournisseur de services pour une implémentation E9-1-1 donnée. Cette cmdlet ne s’exécute pas tant qu’elle peut résoudre l’URL et les informations de sécurité du service Web.
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-CsLisServiceProvider : 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-CsLisServiceProvider"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
CertFileName |
Obligatoire |
Chaîne |
Nom (et chemin complet) du fichier de certificat. L’extension de ce fichier doit être PFX. |
Password |
Obligatoire |
SecureString |
Chaîne sécurisée contenant le mot de passe nécessaire pour accéder au certificat du fichier protégé par mot de passe. Les chaînes sécurisées peuvent être créées à l’aide des cmdlets ConvertTo-SecureString ou Read-Host avec le paramètre AsSecureString. |
ServiceProviderName |
Obligatoire |
Chaîne |
Nom du fournisseur de routage de réseau E9-1-1. |
ValidationServiceUrl |
Obligatoire |
Chaîne |
URL du service Web. Cette URL doit être sécurisée et commencer par le préfixe https://. |
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 des objets du fournisseur de service LIS (Location Information Server).
Types de retours
Cette cmdlet crée ou modifie un objet de type System.Management.Automation.PSCustomObject.
Exemple
-------------------------- Exemple 1 --------------------------
$p = Read-Host -AsSecureString
Set-CsLisServiceProvider -ServiceProviderName E911Provider -ValidationServiceUrl https://www.911contoso.com/validation/ -CertFileName C:\MS-Contoso-Cert.pfx -Password $p
L’un des paramètres requis pour créer une entrée pou un service Web de fournisseur de routage de réseau E9-1-1 est une chaîne sécurisée contenant le mot de passe d’accès au fichier de certificat. Pour cette raison, la première ligne de cet exemple est un appel vers la cmdletRead-Host de Windows PowerShell Read-Host invite l’utilisateur à intervenir. Nous spécifions le paramètre AsSecureString, qui affichera l’entrée saisie sous forme d’astérisques (*). Nous avons assigné le résultat de cette commande à la variable $p. Le résultat consiste en une chaîne sécurisée, qui est une version chiffrée de l’entrée de l’utilisateur. En d’autres termes, l’exécution de cette commande entraîne la demande de saisie du mot de passe du service Web et le stockage de ce mot de passe dans la variable $p.
Nous disposons désormais du mot de passe et nous pouvons créer un objet qui accédera au service Web. Pour cela, nous appelons la cmdlet Set-CsLisServiceProvider. Nous transmettons plusieurs paramètres à cette cmdlet. Le premier correspond au nom du fournisseur ; dans ce cas E911Provider. Nous indiquons ensuite une valeur pour ValidationServiceUrl, https://www.911contoso.com/validation/. Notez qu’il doit s’agir d’un site sécurisé, avec le préfixe https plutôt que http. Nous saisissons ensuite le nom du fichier contenant le certificat utilisé pour accéder à ce service Web, C:\MS-Contoso-Cert.pfx. Nous transmettons enfin la variable $p (contenant la chaîne sécurisée par le mot de passe du service Web) au paramètre Password.