Set-CsLisServiceProvider
Letztes Änderungsdatum des Themas: 2012-03-27
Erstellt oder ändert Informationen zu dem vom Netzwerkroutinganbieter für 9-1-1 (erweitert) (E9-1-1) bereitgestellten Webdienst, um Standorte zu überprüfen.
Syntax
Set-CsLisServiceProvider -CertFileName <String> -Password <SecureString> -ServiceProviderName <String> -ValidationServiceUrl <String> [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]]
Detaillierte Beschreibung
In einer Enterprise-VoIP-Implementierung mit E9-1-1 müssen Notrufe zunächst über einen Netzwerkroutinganbieter für E9-1-1 geroutet werden, um sicherzustellen, dass die Anrufe an die relevante Rettungsleitstelle geroutet werden. (Eine Rettungsleitstelle leitet die Anrufe (in den USA) an Rettungsdienste in der Nähe weiter, z. B. Polizei, Feuerwehr oder Rettungsdienste.) Hierzu muss dem Anbieter von der Organisation eine Liste von Standorten zur Verfügung gestellt werden, die dann anhand der MSAG-Datenbank (Master Street Address Guide) auf Gültigkeit geprüft werden können. Mit diesem Cmdlet werden Informationen zu einem Anbieter erstellt oder geändert, einschließlich des Namens des Anbieters, einer URL für den Webdienst, die die Organisation zum Senden der Standorte verwendet, und einem Zertifikat und Kennwort für den sicheren Webdienst.
Sie können nur einen Dienstanbieter pro E9-1-1-Implementierung definieren. Dieses Cmdlet ist nur dann erfolgreich, wenn die URL und Sicherheitsinformationen für den Webdienst aufgelöst werden können.
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet Set-CsLisServiceProvider lokal ausführen: RTCUniversalServerAdmins. Geben Sie den folgenden Befehl an der Windows PowerShell-Eingabeaufforderung ein, um eine Liste aller rollenbasierten Zugriffssteuerungsrollen zurückzugeben, die diesem Cmdlet zugewiesen wurden (einschließlich der benutzerdefinierten rollenbasierten Zugriffssteuerungsrollen, die Sie selbst erstellt haben):
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsLisServiceProvider"}
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
CertFileName |
Erforderlich |
Zeichenfolge |
Der Name (und vollständige Pfad) der Zertifikatdatei. Die Datei muss die Dateierweiterung PFX aufweisen. |
Password |
Erforderlich |
SecureString |
Eine sichere Zeichenfolge, die das Kennwort für den Zugriff auf das Zertifikat in der kennwortgeschützten Datei enthält. Sichere Zeichenfolgen können mit dem Cmdlet ConvertTo-SecureString oder dem Cmdlet Read-Host unter Verwendung des Parameters "AsSecureString" erstellt werden. |
ServiceProviderName |
Erforderlich |
Zeichenfolge |
Der Name des E9-1-1-Netzwerkroutinganbieters. |
ValidationServiceUrl |
Erforderlich |
Zeichenfolge |
Die URL des Webdiensts. Hierbei muss es sich um eine sichere URL handeln, die mit dem Präfix "https://" beginnt. |
WhatIf |
Optional |
Switch-Parameter |
Beschreibt die Auswirkungen einer Ausführung des Befehls, ohne den Befehl tatsächlich auszuführen. |
Confirm |
Optional |
Switch-Parameter |
Fordert Sie vor der Ausführung des Befehls zum Bestätigen auf. |
Eingabetypen
Akzeptiert eine weitergeleitete Eingabe von LIS-Dienstanbieterobjekten (Location Information Server).
Rückgabetypen
Mit diesem Cmdlet wird ein Objekt vom Typ "System.Management.Automation.PSCustomObject" abgerufen oder geändert.
Beispiel
-------------------------- Beispiel 1 --------------------------
$p = Read-Host -AsSecureString
Set-CsLisServiceProvider -ServiceProviderName E911Provider -ValidationServiceUrl https://www.911contoso.com/validation/ -CertFileName C:\MS-Contoso-Cert.pfx -Password $p
Einer der Parameter, die für das Erstellen eines Eintrags für einen vom E9-1-1-Netzwerkroutinganbieter bereitgestellten Webdienst erforderlich sind, ist eine sichere Zeichenfolge, die das Kennwort für den Zugriff auf die Zertifikatdatei enthält. Daher enthält die erste Zeile in diesem Beispiel einen Aufruf des Windows PowerShell-Cmdlets Read-Host. Read-Host fordert zur Benutzereingabe auf. Der Parameter "AsSecureString" bewirkt, dass diese Eingabe als Sternchen (*) angezeigt wird. Das Ergebnis dieses Befehls wurde der Variablen "$p" zugewiesen, wodurch eine sichere Zeichenfolge entsteht, d. h. eine verschlüsselte Version der Benutzereingabe. Anders ausgedrückt: Wenn dieser Befehl ausgeführt wird, wird der Benutzer zur Eingabe des Kennworts für den Webdienst aufgefordert und dieses Kennwort in der Variablen "$p" gespeichert.
Da nun das Kennwort vorliegt, kann ein Objekt für den Zugriff des Webdiensts erstellt werden. Hierzu wird das Cmdlet Set-CsLisServiceProvider aufgerufen. An dieses Cmdlet werden mehrere Parameter übergeben. Der erste Parameter ist der Name des Dienstanbieters, in diesem Fall "E911Provider". Anschließend wird ein Wert für den Parameter "ValidationServiceUrl" angegeben, hier "https://www.911contoso.com/validation/". Beachten Sie, dass es sich um eine "sichere Site" handeln muss, die nicht mit dem Präfix "http", sondern mit dem Präfix "https" beginnt. Anschließend wird der Name der Datei angegeben, die das Zertifikat für den sicheren Zugriff auf diesen Webdienst enthält: C:\MS-Contoso-Cert.pfx. Abschließend wird die Variable "$p" (diese enthält die sichere Zeichenfolge mit dem Kennwort für den Webdienst) an den Parameter "Password" übergeben.