Test-CsGroupIM
Ultima modifica dell'argomento: 2012-03-26
Consente di testare la capacità di due utenti di condurre una conferenza di messaggistica istantanea. Test-CsGroupIM è una "transazione sintetica": una simulazione delle normali attività di Microsoft Lync Server 2010 utilizzata per monitorare le prestazioni e lo stato.
Sintassi
Test-CsGroupIM -TargetFqdn <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-ReceiverSipAddress <String>] [-RegistrarPort <Nullable>] [-SenderSipAddress <String>]
Test-CsGroupIM [-TargetFqdn <String>] -ReceiverCredential <PSCredential> -ReceiverSipAddress <String> -SenderCredential <PSCredential> -SenderSipAddress <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>]
Descrizione dettagliata
Test-CsGroupIM è un esempio di transazione sintetica Lync Server 2010. 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, ricordare che sarà necessario fornire le credenziali di tutti gli utenti coinvolti.
Il cmdlet Test-CsGroupIM consente di verificare che gli utenti dell'organizzazione possano condurre delle conferenze. Per eseguire i test con il cmdlet Test-CsGroupIM sono necessari due account utente. 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-CsGroupIM utilizzerà automaticamente gli account assegnati al pool. Per informazioni dettagliate, vedere l'argomento New-CsHealthMonitoringConfiguration nella Guida. In alternativa, è possibile eseguire il test utilizzando account non assegnati alla registrazione. Ciò consente di eseguire i test anche nel caso in cui non siano stati configurati gli utenti di test per il pool. Inoltre, questa soluzione permette di testare la capacità di due utenti specifici di condurre una conferenza. Se si sceglie questo metodo, sarà necessario fornire nome utente e password per entrambi gli utenti.
Quando si utilizza il cmdlet Test-CsGroupIM, il cmdlet tenta di eseguire l'accesso a Lync Server per entrambi gli utenti. Se l'accesso riesce, il cmdlet Test-CsGroupIM crea una nuova conferenza utilizzando il primo utente di test, quindi invita il secondo utente a parteciparvi. Dopo uno scambio di messaggi, entrambi gli utenti vengono disconnessi 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. Ad esempio, anche quando l'account di test di Davide Garghentini si disconnette, il vero Davide Garghentini resterà connesso al sistema. Allo stesso modo, il vero Davide Garghentini non riceverà l'invito a partecipare alla conferenza. L'invio verrà inviato all'account di test e da quest'ultimo accettato.
Se si aggiunge il parametro Verbose, è possibile ottenere una descrizione dettagliata di tutte le azioni eseguite dal cmdlet Test-CsGroupIM 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-CsGroupIM"}
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
TargetFqdn |
Obbligatorio |
Stringa |
Nome di dominio completo (FQDN) del pool da testare. |
ReceiverCredential |
Facoltativo |
Oggetto PSCredential |
L'oggetto credenziali utente per il primo dei due account utente da sottoporre a test. Il valore specificato per il parametro ReceiverCredential deve essere un riferimento oggetto ottenuto tramite il cmdlet Get-Credential. Ad esempio, questo codice restituisce un oggetto credenziali per l'utente litwareinc\pilar e lo memorizza nella variabile denominata $y: $y = Get-Credential "litwareinc\pilar" È necessario immettere la password utente quando si esegue questo comando. Le credenziali del destinatario non sono necessarie se si sta eseguendo il test nell'ambito delle impostazioni di configurazione per il monitoraggio dello stato di integrità del pool. |
ReceiverSipAddress |
Facoltativo |
Stringa |
L'indirizzo SIP per il primo dei due account utente da sottoporre a test. Ad esempio: -ReceiverSipAddress "sip:pilar@litwareinc.com". Il parametro ReceiverSipAddress deve fare riferimento allo stesso account utente di ReceiverCredential. L'indirizzo SIP non è necessario se si sta eseguendo il test nell'ambito delle impostazioni di configurazione per il monitoraggio dello stato di integrità del pool. |
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. |
SenderCredential |
Facoltativo |
Oggetto PSCredential |
L'oggetto credenziali utente per il secondo dei due account utente da sottoporre a test. Il valore specificato per il parametro SenderCredential 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. Le credenziali del mittente non sono necessarie se si sta eseguendo il test nell'ambito delle impostazioni di configurazione per il monitoraggio dello stato di integrità del pool. |
SenderSipAddress |
Facoltativo |
Stringa |
L'indirizzo SIP del secondo dei due account utente da testare. Ad esempio: -SenderSipAddres "sip:davidegarghentini@litwareinc.com". Il parametro SenderSIPAddress deve fare riferimento allo stesso account utente di SenderCredential. L'indirizzo SIP non è necessario se si sta eseguendo il test nell'ambito delle impostazioni di configurazione per il monitoraggio dello stato di integrità del pool. |
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 |
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-CsGroupIM non accetta input tramite pipeline.
Tipi restituiti
Test-CsGroupIM restituisce un'istanza dell'oggetto Microsoft.Rtc.SyntheticTransactions.TaskOutput.
Esempio
-------------------------- Esempio 1 --------------------------
Test-CsGroupIm -TargetFqdn atl-cs-001.litwareinc.com
Nell'esempio precedente viene effettuato un controllo per verificare se due utenti di test preconfigurati sono in grado di accedere al pool atl-cs-001.litwareinc.com e quindi prendere parte a una conferenza di messaggistica istantanea. Questo comando potrà essere eseguito correttamente solo se sono stati definiti gli utenti di test per il pool atl-cs-001.litwareinc.com. In caso affermativo, il comando consente di stabilire se i due utenti di test possono accedere al sistema e se sono in grado di partecipare a una conferenza di messaggistica istantanea.
Se gli utenti di test non sono stati definiti, il comando avrà esito negativo in quanto non sarà in grado di stabilire con quali utenti effettuare il test. Se non è stato definito alcun utente di test per un pool, è necessario includere i parametri SenderSipAddress e ReceiverSipAddress e le credenziali corrispondenti per gli utenti coinvolti nella sessione di messaggistica istantanea. I controlli verranno quindi eseguiti da Test-CsGroupIM utilizzando i due utenti specificati.
-------------------------- Esempio 2 --------------------------
$cred1 = Get-Credential "litwareinc\pilar"
$cred2 = Get-Credential "litwareinc\kenmyer"
Test-CsGroupIm -TargetFqdn atl-cs-001.litwareinc.com -SenderSipAddress "sip:pilar@litwareinc.com" -SenderCredential $cred1 -ReceiverSipAddress "sip:kenmyer@litwareinc.com" -ReceiverCredential $cred2
I comandi riportati nell'Esempio 2 consentono di verificare se due utenti (litwareinc\pilar e litwareinc\davidegarghentini) sono in grado di accedere a Lync Server e quindi partecipare a una conferenza di messaggistica istantanea. 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 risultante 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 esegue la stessa operazione, ma questa volta restituisce un oggetto credenziali per l'account Davide Garghentini.
Disponendo dei due oggetti credenziali, il terzo comando nell'esempio consente di stabilire se i due utenti sono o meno in grado di accedere a Lync Server e quindi di partecipare a una conferenza di messaggistica istantanea. Per ottenere questo risultato, viene utilizzato il cmdlet Test-CsGroupIM con i seguenti parametri: TargetFqdn (nome completo del dominio del pool di registrazione); SenderSipAddress (indirizzo SIP dell'utente 1); SenderCredential (credenziali utente dell'utente 1); ReceiverSipAddress (indirizzo SIP dell'utente 2); ReceiverCredential (credenziali utente dell'utente 2).