Test-CsAddressBookService
Ultima modifica dell'argomento: 2012-03-26
Verifica la capacità di un utente di accedere al server che ospita il servizio Web di scaricamento della Rubrica.
Sintassi
Test-CsAddressBookService -TargetFqdn <String> [-External <SwitchParameter>] [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>] [-UserSipAddress <String>]
Test-CsAddressBookService -TargetUri <String> -UserSipAddress <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-WebCredential <PSCredential>]
Test-CsAddressBookService [-TargetFqdn <String>] -UserCredential <PSCredential> -UserSipAddress <String> [-External <SwitchParameter>] [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>]
Descrizione dettagliata
Test-CsAddressBookService è un esempio di "transazione sintetica". Le transazioni sintetiche sono utilizzate in 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-CsAddressBookService mette a disposizione un modo per verificare se un utente può connettersi al servizio Web di scaricamento della Rubrica. Quando si esegue il cmdlet, Test-CsAddressBookService si connette al servizio Web di scaricamento della Rubrica sul pool specificato e richiede il percorso dei file della Rubrica. Se il servizio Web di scaricamento della Rubrica fornisce tale percorso, il test è superato. Se la richiesta viene rifiutata, l'esito del test è negativo.
È possibile testare il servizio Web di scaricamento della Rubrica in due modi diversi: testando il servizio stesso oppure testando il servizio Web associato.
Utenti che possono eseguire questo cmdlet: per impostazione predefinita, i membri dei gruppi riportati di seguito sono autorizzati ad eseguire il cmdlet Test-CsAddressBookService 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-CsAddressBookService"}
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
UserCredential |
Obbligatorio |
Oggetto credenziale PS |
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, con il codice seguente viene restituito un oggetto credenziale per l'utente litwareinc\davidegarghentini e tale oggetto viene archiviato 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-CsAddressBookService esegue i controlli utilizzando l'account dell'utente connesso. |
External |
Facoltativo |
Parametro opzionale |
Consente di verificare se gli utenti esterni possono utilizzare il servizio Web di scaricamento 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. |
TargetFqdn |
Facoltativo |
Stringa |
Il nome di dominio completo del pool di registrazione in cui testare il servizio Web di scaricamento della Rubrica. Ad esempio: -TargetFqdn "atl-cs-001.litwareinc.com". Non è possibile utilizzare il parametro TargetUri e il parametro TargetFqdn nello stesso comando. |
TargetUri |
Facoltativo |
Stringa |
L'URI (Uniform Resource Identifier) del servizio query Web della Rubrica. Ad esempio: -TargetUri "https://atl-cs-001.litwareinc.com/abs/handler". Non è possibile utilizzare il parametro TargetUri e il parametro TargetFqdn nello stesso comando. |
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 |
Obbligatorio |
Parametro opzionale |
Consente di segnalare l'attività dettagliata sullo schermo durante l'esecuzione del cmdlet. |
Tipi di input
Nessuno. Test-CsAddressBookService non accetta l'input da pipeline.
Tipi restituiti
Test-CsAddressBookService restituisce un'istanza dell'oggetto Microsoft.Rtc.SyntheticTransactions.TaskOutput.
Esempio
-------------------------- Esempio 1 --------------------------
Test-CsAddressBookService -TargetFqdn atl-cs-001.litwareinc.com
Con l'esempio precedente viene testato il servizio Web di scaricamento della Rubrica per il pool atl-cs-001.litwareinc.com. Questo comando testa il servizio Web di scaricamento della Rubrica utilizzando utenti di test preconfigurati per il pool atl-cs-001.litwareinc.com.
-------------------------- Esempio 2 --------------------------
$cred1 = Get-Credential "litwareinc\kenmyer"
Test-CsAddressBookService -TargetFqdn atl-cs-001.litwareinc.com -UserCredential $cred1 -UserSipAddress "sip:kenmyer@litwareinc.com"
Anche i comandi mostrati nell'esempio 2 consentono di testare la disponibilità del server che eseguono il servizio Web di scaricamento 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-CsAddressBookService per testare il servizio Web di scaricamento 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. Inoltre, deve essere fornito l'indirizzo SIP di Ken utilizzando il parametro UserSipAddress.
-------------------------- Esempio 3 --------------------------
Test-CsAddressBookService -TargetUri https://atl-cs-001.litwareinc.com/abs/handler -UserSipAddress "sip:kenmyer@litwareinc.com"
Nell'esempio 3 viene illustrato come testare il servizio Web di scaricamento della Rubrica per atl-cs-001.litwareinc.com. A tale scopo, viene chiamato Test-CsAddressBookService con due parametri: TargetUri, che specifica l'URI del servizio Web di scaricamento della Rubrica, e UserSipAddress, che contiene l'indirizzo SIP di Windows PowerShell per l'account utente utilizzato nel test.