Test-CsLisConfiguration
Letztes Änderungsdatum des Themas: 2012-03-26
Testet die LIS-Konfiguration (Location Information Server).
Syntax
Test-CsLisConfiguration -TargetFqdn <String> [-BssId <String>] [-ChassisId <String>] [-External <SwitchParameter>] [-Force <SwitchParameter>] [-Mac <String>] [-OutVerboseVariable <String>] [-PortId <String>] [-PortIdSubType <InterfaceAlias | InterfaceName | LocallyAssigned>] [-RegistrarPort <Nullable>] [-Subnet <String>] [-UserSipAddress <String>]
Test-CsLisConfiguration -TargetUri <String> -UserSipAddress <String> [-BssId <String>] [-ChassisId <String>] [-Force <SwitchParameter>] [-Mac <String>] [-OutVerboseVariable <String>] [-PortId <String>] [-PortIdSubType <InterfaceAlias | InterfaceName | LocallyAssigned>] [-Subnet <String>] [-WebCredential <PSCredential>]
Test-CsLisConfiguration [-TargetFqdn <String>] -UserCredential <PSCredential> -UserSipAddress <String> [-BssId <String>] [-ChassisId <String>] [-External <SwitchParameter>] [-Force <SwitchParameter>] [-Mac <String>] [-OutVerboseVariable <String>] [-PortId <String>] [-PortIdSubType <InterfaceAlias | InterfaceName | LocallyAssigned>] [-RegistrarPort <Nullable>] [-Subnet <String>]
Detaillierte Beschreibung
Mit diesem Cmdlet wird ermittelt, ob der LIS-Webdienst (Location Information Server) basierend auf den in den angegebenen Parametern bereitgestellten Informationen kontaktiert werden kann. Wenn der Webdienst kontaktiert werden kann und ein Standort für die angegebenen Parameter ermittelt wird, wird der Test als erfolgreich betrachtet, und der Standort wird angezeigt. Auch wenn der Standort nicht gefunden wird und der Webdienst dennoch kontaktiert werden kann, gilt der Test als erfolgreich, es werden jedoch keine Standortinformationen zurückgegeben. Wenn Sie dieses Cmdlet ohne optionale Parameter aufrufen, wird der Test dennoch erfolgreich abgeschlossen, sofern der Webdienst kontaktiert werden kann. Auch in diesem Fall werden jedoch keine Standortinformationen zurückgegeben.
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet Test-CsLisConfiguration 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 "Test-CsConfiguration"}
Parameter
Parameter | Erforderlich | Typ | Beschreibung |
---|---|---|---|
TargetFqdn |
Erforderlich |
Zeichenfolge |
Der vollqualifizierte Domänenname (mit dem Format "server.litwareinc.com") des Servers, für den der Test ausgeführt werden soll. Dieser Parameter ist erforderlich, wenn Sie den Parameter "TargetUri" nicht angeben. Wenn Sie "TargetUri" angeben, kann "TargetFqdn" nicht festgelegt werden. |
TargetUri |
Erforderlich |
Zeichenfolge |
Der URI (Uniform Resource Identifier) des Standortinformationsdiensts. Sie können den URI des Standortinformationsdiensts über folgenden Befehl abrufen: Get-CsService –WebServer | Select-Object LIServiceInternalUri Wenn für diesen Parameter ein Wert angegeben wird, ist der Parameter "UserSipAddress" ebenfalls erforderlich. Wenn der Computer, auf dem Sie den Befehl ausführen, kein Serverzertifikat besitzt, müssen Sie außerdem einen Wert für den Parameter "WebCredential" angeben. Dieser Parameter ist nur dann nicht erforderlich, wenn Sie den Parameter "TargetFqdn" angeben. |
UserCredential |
Erforderlich |
PSCredential |
Ein Objekt mit den Benutzeranmeldeinformationen für den Zugriff auf den Standortinformationsdienst. Dieses Objekt kann abgerufen werden, indem Sie das Cmdlet Get-Credential aufrufen und die entsprechenden Anmeldeinformationen angeben. Dieser Parameter ist erforderlich, wenn die Parameter "TargetFqdn" und "UserSipAddress" angegeben werden und wenn der Computer, auf dem Sie das Cmdlet ausführen, kein Serverzertifikat besitzt. |
UserSipAddress |
Erforderlich |
Zeichenfolge |
Die SIP-Adresse eines Remotebenutzers. Wenn Sie für diesen Parameter einen Wert angeben, ist auch der Parameter "TargetFqdn" oder "TargetUri" erforderlich. Dieser Parameter muss bei Verwendung des Parameters "TargetFqdn" nur dann angegeben werden, wenn Sie keine Benutzer für synthetische Transaktionen eingerichtet haben. Führen Sie das Cmdlet Get-CsHealthMonitoringConfiguration aus, um festzustellen, ob Benutzer für synthetische Transaktionen eingerichtet wurden. |
BssId |
Optional |
Zeichenfolge |
Der Basic Service Set Identifier (BSSID) eines drahtlosen Zugriffspunkts. Der Wert muss in der Form "nn-nn-nn-nn-nn-nn" vorliegen, z. B. "12-34-56-78-90-ab". |
ChassisId |
Optional |
Zeichenfolge |
Die MAC-Adresse (Media Access Control) eines Netzwerkswitches. Der Wert muss in der Form "nn-nn-nn-nn-nn-nn" vorliegen, z. B. "12-34-56-78-90-ab", oder in Form einer IP-Adresse. |
External |
Optional |
Switch-Parameter |
Dieser Parameter wird für LIS (Location Information Server) nicht unterstützt. |
Mac |
Optional |
Zeichenfolge |
Die MAC-Adresse des Portswitches. Der Wert muss in der Form "nn-nn-nn-nn-nn-nn" vorliegen, z. B. "12-34-56-78-90-ab". |
PortId |
Optional |
Zeichenfolge |
Die ID des Ports, der dem zu testenden Standort zugeordnet ist. Bei diesem Wert kann es sich auch um eine MAC- oder IP-Adresse handeln. |
PortIdSubType |
Optional |
PortIDSubType |
Der Untertyp des Ports. Dieser Wert kann als numerischer Wert oder als Zeichenfolge eingegeben werden, es muss sich jedoch um einen gültigen Untertyp handeln. Gültige Untertypen: 1: InterfaceAlias 5: InterfaceName 7: LocallyAssigned |
RegistrarPort |
Optional |
System.Nullable |
Die Portnummer des Registrierungsdiensts. |
Subnet |
Optional |
Zeichenfolge |
Die IP-Adresse eines Subnetzes. Dieser Wert wird als IPv4-Adresse (bei der Ziffern durch Punkte getrennt sind, z. B. 192.0.2.0) eingegeben. |
WebCredential |
Optional |
PSCredential |
Ein Objekt mit den Benutzeranmeldeinformationen für den Zugriff auf den Standortinformationsdienst. Dieses Objekt kann abgerufen werden, indem Sie das Cmdlet Get-Credential aufrufen und die entsprechenden Anmeldeinformationen angeben. Dieser Parameter ist erforderlich, wenn die Parameter "TargetUri" und "UserSipAddress" angegeben werden und wenn der Computer, auf dem Sie den Befehl ausführen, kein Serverzertifikat besitzt. |
OutVerboseVariable |
Optional |
Zeichenfolge |
Falls angegeben, wird nach Ausführung des Cmdlets die detaillierte Ausgabe in der angegebenen Variablen gespeichert. Geben Sie beispielsweise die folgende Syntax an, um die Ausgabe in der Variablen "$Testausgabe" zu speichern: -OutVerboseVariable Testausgabe Setzen Sie kein Dollarzeichen ($) vor den Variablennamen. |
Force |
Optional |
Switch-Parameter |
Unterdrückt alle Bestätigungsaufforderungen, die andernfalls vor der Durchführung von Änderungen angezeigt würden. |
Eingabetypen
Keine.
Rückgabetypen
Mit Test-CsLisConfiguration wird eine Instanz des Objekts "Microsoft.Rtc.SyntheticTransactions.TaskOutput" zurückgegeben.
Beispiel
-------------------------- Beispiel 1 --------------------------
Test-CsLisConfiguration -TargetFqdn atl-cs-001.litwareinc.com -Subnet 192.168.0.0
In diesem Beispiel wird die LIS-Konfiguration für den FQDN "atl-cs-001.litwareinc.com" getestet. Der Test ist erfolgreich, wenn bei Verwendung dieses vollqualifizierten Domänennamens mit den aktuellen Benutzeranmeldeinformationen eine Verbindung mit dem LIS-Webdienst hergestellt werden kann. Wenn ein übereinstimmender Standort für die Subnetz-IP-Adresse 192.168.0.0 ermittelt wird, wird diese Standortadresse zurückgegeben.
Damit dieser Befehl erfolgreich ausgeführt werden kann, muss eine Integritätsüberwachungskonfiguration mit Benutzern für synthetische Transaktionen vorhanden sein. Führen Sie das Cmdlet Get-CsHealthMonitoringConfiguration aus, um festzustellen, ob eine Integritätsüberwachungskonfiguration vorliegt. Führen Sie das Cmdlet New-CsHealthMonitoringConfiguration aus, um eine Integritätsüberwachungskonfiguration zu erstellen.
-------------------------- Beispiel 2 --------------------------
Test-CsLisConfiguration -TargetFqdn atl-cs-001.litwareinc.com -Subnet 192.168.0.0 -UserSipAddress sip:kmyer@litwareinc.com
Dieses Beispiel entspricht Beispiel 1, fügt jedoch den Parameter "UserSipAddress" hinzu. Verwenden Sie diesen Befehl, wenn keine Benutzer für synthetische Transaktionen eingerichtet wurden, der zur Ausführung des Befehls verwendete Computer jedoch ein Serverzertifikat besitzt.
-------------------------- Beispiel 3 --------------------------
$cred = Get-Credential
Test-CsLisConfiguration -TargetFqdn atl-cs-001.litwareinc.com -Subnet 192.168.0.0 -UserSipAddress sip:kmyer@litwareinc.com -UserCredential $cred
Über die erste Zeile in diesem Beispiel wird das Windows PowerShell-Cmdlet Get-Credential aufgerufen, über das der Benutzer zur Eingabe einer Benutzer-ID und eines Kennworts aufgefordert wird. Diese Informationen werden in verschlüsselter Form in der Variablen "$cred" gespeichert.
Die zweite Zeile entspricht dem Befehl in Beispiel 2, fügt jedoch den Parameter "UserSipAddress" hinzu. Verwenden Sie diesen Befehl, wenn keine Benutzer für synthetische Transaktionen eingerichtet wurden und wenn der zur Ausführung des Befehls verwendete Computer kein Serverzertifikat besitzt.
-------------------------- Beispiel 4 --------------------------
$cred = Get-Credential
Test-CsLisConfiguration -TargetUri https://atl-cs-001.litwareinc.com/locationinformation/lisservice.svc -UserSipAddress sip:kmyer@litwareinc.com -WebCredential $cred -Subnet 192.168.0.0 -Mac 0A-23-00-00-00-AA -PortId 4500 -ChassisId 0A-23-00-00-00-AA
Über die erste Zeile in diesem Beispiel wird das Cmdlet Get-Credential aufgerufen, über das der Benutzer zur Eingabe einer Benutzer-ID und eines Kennworts aufgefordert wird. Diese Informationen werden in verschlüsselter Form in der Variablen "$cred" gespeichert.
In Zeile 2 wird die LIS-Konfiguration getestet, indem der Webdienst-URI (https://atl-cs-001.litwareinc.com/locationinformation/lisservice.svc) basierend auf der SIP-Adresse des Remotebenutzers (sip:kmyer@litwareinc.com) aufgerufen wird und die in Zeile 1 abgerufenen Anmeldeinformationen an den Parameter "WebCredential" weitergeleitet werden. Der Test ist erfolgreich, wenn bei Verwendung dieses URI mit den bereitgestellten Benutzeranmeldeinformationen eine Verbindung mit dem LIS-Webdienst hergestellt werden kann. Wenn ein übereinstimmender Standort ermittelt wird, der die Subnetz-IP-Adresse 192.168.0.0, die MAC-Adresse "0A-23-00-00-00-AA" oder die Port-ID 4500 sowie für "ChassisId" den Wert "0A-23-00-00-00-AA" aufweist, wird diese Standortadresse zurückgegeben.
Verwenden Sie diesen Befehl, wenn der zur Ausführung des Befehls verwendete Computer kein Serverzertifikat besitzt.
-------------------------- Beispiel 5 --------------------------
Test-CsLisConfiguration -TargetUri https://atl-cs-001.litwareinc.com/locationinformation/lisservice.svc -UserSipAddress sip:kmyer@litwareinc.com -Subnet 192.168.0.0 -Mac 0A-23-00-00-00-AA -PortId 4500 -ChassisId 0A-23-00-00-00-AA
Dieses Beispiel entspricht Beispiel 4, außer dass der Parameter "WebCredential" nicht verwendet wird (und somit Get-Credential nicht aufgerufen wird). Verwenden Sie diesen Befehl, wenn der zur Ausführung des Befehls verwendete Computer ein Serverzertifikat besitzt.
Siehe auch
Weitere Ressourcen
Debug-CsLisConfiguration
Publish-CsLisConfiguration
Unpublish-CsLisConfiguration
Import-CsLisConfiguration
Export-CsLisConfiguration