Test-CsAddressBookWebQuery
Ultima modifica dell'argomento: 2012-03-25
Verifica la capacità di un utente di cercare e restituire informazioni dalla Rubrica utilizzando il servizio query Web della Rubrica.
Sintassi
Test-CsAddressBookWebQuery -TargetFqdn <String> [-External <SwitchParameter>] [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>] [-TargetSipAddress <String>] [-UserSipAddress <String>]
Test-CsAddressBookWebQuery -TargetUri <String> -UserSipAddress <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-TargetSipAddress <String>] [-WebCredential <PSCredential>]
Test-CsAddressBookWebQuery [-TargetFqdn <String>] -UserCredential <PSCredential> -UserSipAddress <String> [-External <SwitchParameter>] [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>] [-TargetSipAddress <String>]
Descrizione dettagliata
Test-CsAddressBookWebQuery è un esempio di "transazione sintetica". Le transazioni sintetiche sono utilizzate in Microsoft Lync Server 2010 per verificare che gli utenti siano in grado di completare correttamente le attività comuni quali l'accesso al sistema, lo scambio di messaggi istantanei o l'effettuazione di telefonate a un telefono appartenente alla rete PSTN (Public Switched Telephone Network). Tali verifiche possono essere condotte manualmente da un amministratore oppure possono essere eseguite automaticamente tramite un'applicazione quale Microsoft System Center Operations Manager (in precedenza Microsoft Operations Manager).
Le transazioni sintetiche vengono in genere condotte in due modi distinti. Molti amministratori utilizzeranno i cmdlet CsHealthMonitoringConfiguration per configurare utenti di test per ciascuno dei propri pool di registrazione. Questi utenti di test sono una coppia di utenti preconfigurati per essere utilizzati nell'ambito delle transazioni sintetiche. Generalmente si tratta di account di test e non di account appartenenti a utenti effettivi. Quando vengono configurati gli utenti di test per un pool, gli amministratori possono semplicemente eseguire una transazione sintetica su tale pool, senza dover specificare le identità degli account utente (e fornire le relative credenziali) coinvolti nel test.
In alternativa, gli amministratori possono eseguire una transazione sintetica utilizzando account utente effettivi. Ad esempio, se due utenti non sono in grado di scambiare messaggi istantanei, un amministratore potrebbe eseguire una transazione sintetica utilizzando i due account utente in questione (anziché una coppia di account di test) e provare a diagnosticare e risolvere il problema. Se si decide di condurre una transazione sintetica utilizzando gli account utente reali, sarà necessario fornire i nomi di accesso e le password per ogni utente.
Il cmdlet Test-CsAddressBookWebQuery mette a disposizione degli amministratori un modo per verificare se gli utenti possono utilizzare il servizio query Web della Rubrica per cercare un contatto specifico. Quando si esegue il cmdlet, Test-CsAddressBookWebQuery si connette al servizio Web Ticket per l'autenticazione. Se l'autenticazione ha esito positivo, il cmdlet si connette al servizio query Web della Rubrica e ricerca il contatto specificato. Se tale contatto viene individuato, il cmdlet tenta di restituire tale informazione al computer locale. Il test viene considerato superato solo se è possibile completare tutti questi passaggi.
Utenti che possono eseguire questo cmdlet: 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-CsAddressBookWebQuery"}
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
TargetFqdn |
Obbligatorio |
Stringa |
Il nome di dominio completo del pool di registrazione in cui testare il servizio query Web della Rubrica. Ad esempio: -TargetFqdn "atl-cs-001.litwareinc.com". Non è possibile utilizzare il parametro TargetUri e il parametro TargetFqdn nello stesso comando. |
TargetSipAddress |
Obbligatorio |
Indirizzo SIP |
Indirizzo SIP del contatto che dovrebbe essere restituito dal servizio query Web della Rubrica. Ad esempio: -TargetSipAddress "sip:davidegarghentini@litwareinc.com". |
TargetUri |
Obbligatorio |
Stringa |
L'URI (Uniform Resource Identifier) del servizio query Web della Rubrica. Ad esempio: -TargetUri "https://atl-cs-001.litwareinc.com/groupexpansion". Non è possibile utilizzare il parametro TargetUri e il parametro TargetFqdn nello stesso comando. |
UserCredential |
Obbligatorio |
Oggetto PSCredential |
L'oggetto credenziale utente per l'account utente da utilizzare nel test. Il valore trasmesso a UserCredential deve essere un riferimento oggetto ottenuto utilizzando il cmdlet Get-Credential. Ad esempio, questo codice restituisce un oggetto credenziali per l'utente litwareinc\davidegarghentini e memorizza tale oggetto in una variabile denominata $x: $x = Get-Credential "litwareinc\davidegarghentini" È necessario fornire la password utente quando si esegue questo comando. |
UserSipAddress |
Obbligatorio |
Indirizzo SIP |
Indirizzo SIP dell'utente da utilizzare nel test. Se questo parametro non viene specificato, Test-CsAddressBookWebQuery esegue i controlli utilizzando le impostazioni di configurazione del monitoraggio dello stato per il pool in fase di test. |
External |
Facoltativo |
Parametro opzionale |
Consente di verificare se gli utenti esterni possono utilizzare il servizio query Web della Rubrica. |
RegistrarPort |
Facoltativo |
Numero intero |
La porta SIP utilizzata dal servizio di registrazione. Questo parametro non è obbligatorio se il servizio di registrazione utilizza la porta 5061 predefinita. |
WebCredential |
Facoltativo |
Oggetto credenziali PS |
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 in cui viene eseguito il comando non dispone di un certificato del server. |
Force |
Facoltativo |
Parametro opzionale |
Consente di evitare la visualizzazione di qualunque messaggio di errore non grave che potrebbe essere generato nel corso dell'esecuzione del comando. |
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. |
Verbose |
Facoltativo |
Parametro opzionale |
Consente di segnalare l'attività dettagliata sullo schermo durante l'esecuzione del cmdlet. |
Tipi di input
Nessuno. Test-CsAddressBookWebQuery non accetta l'input da pipeline.
Tipi restituiti
Test-CsAddressBookWebQuery restituisce un'istanza dell'oggetto Microsoft.Rtc.SyntheticTransactions.TaskOutput.
Esempio
-------------------------- Esempio 1 ------------------------
Test-CsAddressBookWebQuery -TargetFqdn atl-cs-001.litwareinc.com -TargetSipAddress "sip:kenmyer@litwareinc.com"
Con l'esempio precedente viene testato il servizio query Web della Rubrica per il pool atl-cs-001.litwareinc.com, cercando il contatto con indirizzo SIP sip:davidegarghentini@litwareinc.com. Questo comando funziona solo se sono stati definiti utenti di test per il pool atl-cs-001.litwareinc.com. In tal caso, il comando viene eseguito con le credenziali del primo utente di test definito per il pool.
Se non sono stati definiti utenti di test, il comando non riesce. Se non sono stati definiti utenti di test per un pool, è necessario includere il parametro UserSipAddress e le credenziali dell'utente da utilizzare per eseguire il comando.
-------------------------- Esempio 2 ------------------------
$cred1 = Get-Credential "litwareinc\kenmyer"
Test-CsAddressBookWebQuery -TargetFqdn atl-cs-001.litwareinc.com -UserCredential $cred1 -UserSipAddress "sip:kenmyer@litwareinc.com" -TargetSipAddress "sip:kenmyer@litwareinc.com"
Anche i comandi mostrati nell'esempio 2 consentono di testare la disponibilità del servizio query Web della Rubrica; in questo caso, però, i comandi vengono eseguiti con le credenziali dell'utente Davide Garghentini (litwareinc\davidegarghentini). A tal fine, il primo comando utilizza il cmdlet Get-Credential per creare un oggetto credenziali Windows PowerShell contenente il nome e la password dell'utente Davide Garghentini. Poiché il nome di accesso litwareinc\davidegarghentini è stato incluso come parametro, la finestra di dialogo Richiesta credenziali di Windows PowerShell richiede esclusivamente che l'amministratore immetta la password per l'account Davide Garghentini. L'oggetto credenziali risultante viene memorizzato in una variabile denominata $cred1.
Nel secondo comando viene utilizzato Test-CsAddressBookWebQuery per testare il servizio query Web della Rubrica per il pool atl-cs-001.litwareinc.com. Per eseguire questo comando con le credenziali utente di Davide Garghentini, viene incluso il parametro UserCredential insieme al valore di parametro $cred1. Il comando utilizza anche TargetSipAddress per specificare che il cmdlet dovrebbe cercare nella Rubrica il contatto con indirizzo SIP sip:davidegarghentini@litwareinc.com.
-------------------------- Esempio 3 ------------------------
Test-CsAddressBookWebQuery -TargetUri https://atl-cs-001.litwareinc.com/groupexpansion -UserSipAddress "sip:packerman@litwareinc.com" -TargetSipAddress "sip:kenmyer@litwareinc.com"
Nell'esempio 3 viene illustrato come testare il servizio query Web della Rubrica per atl-cs-001.litwareinc.com. A tale scopo, viene chiamato Test-CsAddressBookWebQuery con tre parametri: TargetUri, che specifica l'URI del servizio query Web della Rubrica, UserSipAddress, che contiene l'indirizzo SIP di Windows PowerShell per l'account utente utilizzato nel test, e TargetSipAddress, che contiene l'indirizzo SIP dell'account utente da cercare.