Test-CsRegistration
Ultima modifica dell'argomento: 2012-03-26
Consente di verificare se un utente è in grado di accedere a Microsoft Lync Server 2010. Test-CsRegistration è una "transazione sintetica": una simulazione delle normali attività di Lync Server 2010 utilizzata per monitorare le prestazioni e lo stato.
Sintassi
Test-CsRegistration -TargetFqdn <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>] [-UserSipAddress <String>]
Test-CsRegistration [-TargetFqdn <String>] -UserCredential <PSCredential> -UserSipAddress <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>]
Descrizione dettagliata
Test-CsRegistration è un esempio di "transazione sintetica" Lync Server. Le transazioni sintetiche vengono utilizzate in Lync Server per verificare che gli utenti siano in grado di completare correttamente normali attività, quali l'accesso al sistema, lo scambio di messaggi istantanei o l'esecuzione di chiamate a un telefono in una rete PSTN (Public Switched Telephone Network). Questi test possono essere eseguiti manualmente da un amministratore oppure automaticamente da un'applicazione (ad esempio, Microsoft System Center Operations Manager (in precedenza Microsoft Operations Manager)).
Per eseguire le transazioni sintetiche è possibile procedere in due modi. Alcuni amministratori utilizzano i cmdlet CsHealthMonitoringConfiguration per configurare utenti di test per ciascun pool di registrazione. Si tratta di un certo numero di utenti che sono stati appositamente preconfigurati per essere utilizzati nell'ambito delle transazioni sintetiche. Generalmente si tratta di account di test che non appartengono a utenti reali. Dopo aver configurato gli utenti di test per un pool, gli amministratori possono semplicemente eseguire una transazione sintetica su quel pool senza dover specificare le identità o fornire le credenziali degli account utente coinvolti nel test.
In alternativa, gli amministratori possono eseguire una transazione sintetica utilizzando degli account utente reali. 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 (piuttosto che degli account utente di test) per cercare di diagnosticare e risolvere il problema. Se si decide di eseguire una transazione sintetica utilizzando degli account utente reali sarà necessario fornire i nomi e le password di accesso di tutti gli utenti coinvolti.
Il cmdlet Test-CsRegistration consente di verificare che gli utenti dell'organizzazione possano accedere a Lync Server. Per eseguire questa verifica, il cmdlet Test-CsRegistration ha bisogno di un singolo account di test. Se sono già stati configurati gli utenti di test per il pool su cui verrà eseguito il test, non sarà necessario specificare questi account, in quanto il cmdlet Test-CsRegistration utilizzerà automaticamente il primo account di test assegnato al pool. Per informazioni dettagliate, vedere l'argomento New-CsHealthMonitoringConfiguration nella Guida. In alternativa, è possibile eseguire il test utilizzando un account che non è stato assegnato al pool. Ciò consente di eseguire i test anche nel caso in cui non siano stati configurati gli utenti di test. Inoltre, questa soluzione permette di testare la capacità di uno specifico utente di accedere a Lync Server. Se si sceglie questo metodo, sarà necessario fornire nome utente e password dell'account da verificare.
Quando viene utilizzato, il cmdlet Test-CsRegistration tenta di eseguire l'accesso a Lync Server con l'account utente di test e, se l'operazione riesce, disconnette l'utente di test dal sistema. Tutta la procedura viene eseguita senza alcuna interazione da parte degli utenti e senza che questi vengano coinvolti. Ad esempio, si supponga che l'account di test sip:davidegarghentini@litwareinc.com corrisponda a un utente reale con un account Lync Server reale. In questo caso, il test verrà eseguito senza coinvolgere il vero Davide Garghentini. Quando l'account di test di Davide Garghentini si disconnette, il vero Davide Garghentini resterà connesso al sistema.
Se si aggiunge il parametro Verbose, è possibile ottenere una descrizione dettagliata di tutte le azioni eseguite dal cmdlet Test-CsRegistration per completare il test.
Utenti autorizzati a utilizzare questo cmdlet: Per ottenere un elenco di tutti i ruoli RBAC (controllo dell'accesso basato sui ruoli) a cui è stato assegnato questo cmdlet (inclusi eventuali ruoli RBAC personalizzati), utilizzare il seguente comando dal prompt di Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Test-CsRegistration"}
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
TargetFqdn |
Obbligatorio |
Stringa |
Nome di dominio completo (FQDN) del pool da testare. |
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 il carattere $ quando si specifica il nome della variabile. |
RegistrarPort |
Facoltativo |
Numero intero |
Porta SIP utilizzata dal servizio di registrazione. Questo parametro non è obbligatorio se il servizio di registrazione utilizza la porta predefinita 5061. |
UserCredential |
Facoltativo |
Oggetto PSCredential |
Credenziali dell'utente titolare dell'account da sottoporre a test. Il valore specificato per il parametro UserCredential deve essere un riferimento oggetto ottenuto tramite il cmdlet Get-Credential. Ad esempio, questo codice restituisce un oggetto credenziali per l'utente litwareinc\davidegarghentini e lo memorizza nella variabile denominata $x: $x = Get-Credential "litwareinc\davidegarghentini" È necessario immettere la password utente quando si esegue questo comando. Questo parametro non è necessario se si sta eseguendo il test nell'ambito delle impostazioni di configurazione per il monitoraggio dello stato di integrità del pool. |
UserSipAddress |
Facoltativo |
Indirizzo SIP |
Indirizzo SIP dell'account utente da sottoporre a test, ad esempio, -UserSipAddress "sip:davidegarghentini@litwareinc.com". Il parametro UserSipAddress deve fare riferimento allo stesso account utente di UserCredential. Questo parametro non è necessario se si sta eseguendo il test nell'ambito delle impostazioni di configurazione per il monitoraggio dello stato di integrità del pool. |
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. |
Verbose |
Facoltativo |
Parametro opzionale |
Consente di visualizzare sullo schermo informazioni dettagliate sull'attività del cmdlet in esecuzione. |
Tipi di input
Nessuno. Test-CsRegistration non accetta input tramite pipeline.
Tipi restituiti
Test-CsRegistration restituisce un'istanza dell'oggetto Microsoft.Rtc.SyntheticTransactions.TaskOutput.
Esempio
-------------------------- Esempio 1 --------------------------
Test-CsRegistration -TargetFqdn atl-cs-001.litwareinc.com
Nell'esempio precedente è stato verificato il servizio di registrazione per il pool atl-cs-001.litwareinc.com. Questo comando potrà essere eseguito correttamente solo se sono stati definiti gli utenti di test per il pool atl-cs-001.litwareinc.com. In questo caso, il comando consente di stabilire se il primo utente di test è in grado di accedere a Lync Server.
Se gli utenti di test non sono stati definiti, il comando avrà esito negativo in quanto non sarà in grado di stabilire con quale account utente tentare di accedere al sistema. Se non sono stati definiti gli utenti di test per un pool, è necessario includere il parametro UserSipAddress e le credenziali dell'utente che il comando dovrà utilizzare quando tenta di eseguire l'accesso.
-------------------------- Esempio 2 --------------------------
$cred1 = Get-Credential "litwareinc\pilar"
Test-CsRegistration -TargetFqdn atl-cs-001.litwareinc.com -UserCredential $cred1 -UserSipAddress "sip:pilar@litwareinc.com"
I comandi riportati nell'Esempio 2 consentono di verificare se uno specifico utente (litwareinc\pilar) è in grado di accedere a Lync Server. Per ottenere questo risultato, il primo comando nell'esempio utilizza il cmdlet Get-Credential per creare un oggetto credenziali Windows PowerShell contenente nome e password dell'utente Luisa Cazzaniga. Dal momento che il nome di accesso (litwareinc\pilar) è stato incluso come parametro, nella finestra di dialogo per la richiesta delle credenziali in Windows PowerShell, l'amministratore dovrà solo immettere la password per l'account di Luisa Cazzaniga. L'oggetto credenziali risultante viene quindi memorizzato nella variabile denominata $cred1.
Il secondo comando consente di verificare se questo utente può accedere al pool atl-cs-001.litwareinc.com. Per eseguire questa operazione, viene utilizzato il cmdlet Test-CsRegistration con tre parametri: TargetFqdn (il nome di dominio completo del pool di registrazione); UserCredential (l'oggetto Windows PowerShell contenente le credenziali utente di Luisa Cazzaniga); UserSipAddress (l'indirizzo SIP corrispondente alle credenziali utente fornite).