Condividi tramite

  • Articolo

Test-CsLisConfiguration

 

Ultima modifica dell'argomento: 2012-03-26

Verifica la configurazione LIS (Location Information Server).

Sintassi

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>]

Descrizione dettagliata

Questo cmdlet consente di determinare se il servizio Web LIS (Location Information Server) può essere contattato in base alle informazioni nei parametri forniti. Se il servizio Web può essere contattato e viene individuata una posizione corrispondente a uno dei parametri forniti, il test viene considerato come superato, quindi viene visualizzata la posizione. Anche nel caso in cui la posizione non venga trovata, il test viene superato se il servizio Web può essere contattato, sebbene senza informazioni sulla posizione. Inoltre, se si chiama questo cmdlet senza fornire i parametri opzionali, il test sarà lo stesso superato (purché sia possibile contattare il servizio Web), ma non saranno restituite informazioni sulla posizione.

Utenti che possono eseguire questo cmdlet: per impostazione predefinita, i membri dei gruppi riportati di seguito sono autorizzati ad eseguire il cmdlet Test-CsLisConfiguration in locale: RTCUniversalServerAdmins. Per restituire un elenco di tutti i ruoli RBAC (Role-Based Access Control, controllo dell'accesso basato sui ruoli) a cui è stato assegnato questo cmdlet (compresi eventuali ruoli RBAC personalizzati creati autonomamente), eseguire il cmdlet riportato di seguito dal prompt di Windows PowerShell:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Test-CsConfiguration"}

Parametri

Parametro Obbligatorio Tipo Descrizione

TargetFqdn

Obbligatorio

Stringa

Il nome di dominio completo (nella forma server.litwareinc.com) del server su cui eseguire il test.

Questo parametro è obbligatorio se non è stato specificato il parametro TargetUri, caso in cui non è possibile specificare TargetFqdn.

TargetUri

Obbligatorio

Stringa

L'URI (Uniform Resource Identifier) del servizio Informazioni percorso. È possibile recuperare l'URI del servizio Informazioni percorso eseguendo il comando riportato di seguito: Get-CsService –WebServer | Select-Object LIServiceInternalUri

Se si specifica un valore per questo parametro, è obbligatorio specificare anche il parametro UserSipAddress. Se il computer su cui è in esecuzione il comando non dispone di un certificato del server, è necessario specificare un valore anche per il parametro WebCredential.

Questo parametro è obbligatorio se non è stato specificato il parametro TargetFqdn.

UserCredential

Obbligatorio

PSCredential

Un oggetto contenente le credenziali utente per l'accesso al servizio Informazioni percorso. Questo oggetto può essere recuperato chiamando il cmdlet Get-Credential e specificando le credenziali appropriate.

Questo parametro è obbligatorio se sono stati specificati i parametri TargetFqdn e UserSipAddress e se il computer da cui viene eseguito il cmdlet non dispone di un certificato del server.

UserSipAddress

Obbligatorio

Stringa

L'indirizzo SIP di un utente remoto.

Se si specifica un valore per questo parametro, è necessario specificare anche un valore per il parametro TargetFqdn o TargetUri.

Questo parametro è obbligatorio se si specifica il parametro TargetFqdn, ma solo se non sono stati impostati utenti di transazione sintetica. Per vedere se sono stati configurati utenti di transazione sintetica, eseguire il cmdlet Get-CsHealthMonitoringConfiguration.

BssId

Facoltativo

Stringa

L'identificatore del set di servizi di base (BSSID) di un punto di accesso wireless. Questo valore deve essere nella forma nn-nn-nn-nn-nn-nn, ad esempio 12-34-56-78-90-ab.

ChassisId

Facoltativo

Stringa

L'indirizzo MAC (Media Access Control) di uno switch di rete. Questo valore deve essere nella forma nn-nn-nn-nn-nn-nn, ad esempio 12-34-56-78-90-ab, oppure deve essere un indirizzo IP.

External

Facoltativo

Parametro opzionale

Questo parametro non è utilizzato per Location Information Server.

Mac

Facoltativo

Stringa

L'indirizzo MAC del commutatore di porte. Questo valore deve essere nella forma nn-nn-nn-nn-nn-nn, ad esempio 12-34-56-78-90-ab.

PortId

Facoltativo

Stringa

L'ID della porta associata alla posizione da testare. Può anche contenere un indirizzo MAC o IP.

PortIdSubType

Facoltativo

PortIDSubType

Il sottotipo della porta. Questo valore può essere immesso come valore numerico o stringa ma deve essere un sottotipo valido. I sottotipi validi sono:

1: InterfaceAlias

5: InterfaceName

7: LocallyAssigned

RegistrarPort

Facoltativo

System.Nullable

Il numero di porta del servizio di registrazione.

Subnet

Facoltativo

Stringa

L'indirizzo IP di una subnet. Il valore dovrebbe essere immesso come un indirizzo IPv4 (cifre separate da punti come 192.0.2.0).

WebCredential

Facoltativo

PSCredential

Un oggetto contenente le credenziali utente per l'accesso al servizio Informazioni percorso. Questo oggetto può essere recuperato chiamando il cmdlet Get-Credential e specificando le credenziali appropriate.

Questo parametro è obbligatorio se sono stati specificati i parametri TargetUri e UserSipAddress e se il computer su cui viene eseguito il cmdlet non dispone di un certificato del server.

OutVerboseVariable

Facoltativo

Stringa

Quando presente, l'output dettagliato relativo all'esecuzione del cmdlet verrà archiviato nella variabile specificata. Per archiviare, ad esempio, l'output in una variabile denominata $TestOutput, utilizzare la sintassi seguente:

-OutVerboseVariable TestOutput

Non anteporre un carattere $ quando si specifica il nome della variabile.

Force

Facoltativo

Parametro opzionale

Elimina qualsiasi richiesta di conferma che, in caso contrario, sarebbe visualizzata prima di effettuare le modifiche.

Tipi di input

Nessuno.

Tipi restituiti

Test-CsLisConfiguration restituisce un'istanza dell'oggetto Microsoft.Rtc.SyntheticTransactions.TaskOutput.

Esempio

-------------------------- Esempio 1 --------------------------

Test-CsLisConfiguration -TargetFqdn atl-cs-001.litwareinc.com -Subnet 192.168.0.0

Con questo esempio viene testata la configurazione LIS per il nome di dominio completo atl-cs-001.litwareinc.com. Il test avrà esito positivo se è possibile effettuare una connessione al servizio Web LIS in corrispondenza di tale nome di dominio completo con le credenziali dell'utente corrente. Se viene individuata una posizione che può essere mappata all'indirizzo IP della subnet 192.168.0.0, viene restituito l'indirizzo di tale posizione.

Perché il comando abbia esito positivo deve esistere una configurazione di monitoraggio dello stato contenente utenti di transazione sintetica. Per vedere se esiste una configurazione di monitoraggio dello stato, eseguire il cmdlet Get-CsHealthMonitoringConfiguration. Per creare una nuova configurazione di monitoraggio dello stato, eseguire il cmdlet New-CsHealthMonitoringConfiguration.

-------------------------- Esempio 2 --------------------------

Test-CsLisConfiguration -TargetFqdn atl-cs-001.litwareinc.com -Subnet 192.168.0.0 -UserSipAddress sip:kmyer@litwareinc.com

Questo esempio è identico all'esempio 1, ma con l'aggiunta del parametro UserSipAddress. Utilizzare questo comando se non sono stati configurati utenti di transazione sintetica e se il computer su cui è in esecuzione il comando dispone di un certificato del server.

-------------------------- Esempio 3 --------------------------

$cred = Get-Credential
Test-CsLisConfiguration -TargetFqdn atl-cs-001.litwareinc.com -Subnet 192.168.0.0 -UserSipAddress sip:kmyer@litwareinc.com -UserCredential $cred

Nella prima riga di questo esempio viene chiamato un cmdlet di Windows PowerShell, Get-Credential, che richiede all'utente un ID e una password. Queste informazioni vengono crittografate e archiviate nella variabile $cred.

La seconda riga è identica al comando nell'esempio 2, ma con l'aggiunta del parametro UserSipAddress. Utilizzare questo comando se non sono stati configurati utenti di transazione sintetica e se il computer su cui è in esecuzione il comando non dispone di un certificato del server.

-------------------------- Esempio 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

Nella prima riga di questo esempio viene chiamato il cmdlet Get-Credential, che richiede all'utente un ID e una password. Queste informazioni vengono crittografate e archiviate nella variabile $cred.

Nella riga 2 viene testata la configurazione LIS effettuando una chiamata all'URI del servizio Web (https://atl-cs-001.litwareinc.com/locationinformation/lisservice.svc) in base all'indirizzo SIP dell'utente remoto (sip:kmyer@litwareinc.com) e fornendo le credenziali ottenute nella riga 1 al parametro WebCredential. Il test avrà esito positivo se è possibile effettuare una connessione al servizio Web LIS in corrispondenza di tale URI con le credenziali utente fornite. Se viene individuata una posizione che può essere mappata all'indirizzo IP della subnet 192.168.0.0, all'indirizzo MAC 0A-23-00-00-00-AA o all'ID di porta 4500 e allo ChassisId 0A-23-00-00-00-AA, viene restituito l'indirizzo di tale posizione.

Utilizzare questo comando se il computer su cui è in esecuzione il comando non dispone di un certificato del server.

-------------------------- Esempio 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

Questo esempio è identico all'esempio 4, tranne per il fatto che il comando non utilizza il parametro WebCredential (e di conseguenza non chiama Get-Credential). Utilizzare questo comando se il computer su cui è in esecuzione il comando dispone di un certificato del server.