Test-CsIM
Ultima modifica dell'argomento: 2012-03-26
Consente di verificare la capacità di due utenti di scambiare messaggi istantanei.
Sintassi
Test-CsIM -TargetFqdn <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-ReceiverSipAddress <String>] [-RegistrarPort <Nullable>] [-SenderSipAddress <String>]
Test-CsIM [-TargetFqdn <String>] -ReceiverCredential <PSCredential> -ReceiverSipAddress <String> -SenderCredential <PSCredential> -SenderSipAddress <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>]
Descrizione dettagliata
Test-CsIM è un esempio di "transazione sintetica" Microsoft Lync Server 2010. Le transazioni sintetiche vengono utilizzate in Lync Server 2010 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 il 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.
Innanzitutto, il cmdlet Test-CsIM tenta di eseguire l'accesso a Lync Server con due account di test. Se l'operazione riesce, il cmdlet avvia una sessione di messaggistica istantanea tra i due utenti di test. L'utente 1 invita l'utente 2 a partecipare a una sessione di messaggistica istantanea e l'utente 2 accetta l'invito. Dopo aver verificato che i due utenti possono scambiare messaggi, il cmdlet Test-CsIM termina la sessione di messaggistica istantanea e scollega i due utenti dal sistema.
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-CsIM"}
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
ReceiverCredential |
Obbligatorio |
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:jhaas@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. |
SenderCredential |
Obbligatorio |
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 |
Obbligatorio |
Stringa |
L'indirizzo SIP del secondo dei due account utente da sottoporre a test. Ad esempio: -SenderSipAddress "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. |
TargetFqdn |
Obbligatorio |
Stringa |
Nome di dominio completo (FQDN) del pool da testare. |
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. |
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-CsIM non accetta input tramite pipeline.
Tipi restituiti
Test-CsIM restituisce un'istanza dell'oggetto Microsoft.Rtc.SyntheticTransactions.TaskOutput.
Esempio
-------------------------- Esempio 1 --------------------------
Test-CsIm -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 scambiare messaggi istantanei. 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 possono accedere al sistema e, in tal caso, scambiare messaggi istantanei.
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 è stata definita alcuna funzione di registrazione per un pool, è necessario includere i parametri SenderSipAddress e ReceiverSipAddress oltre alle credenziali corrispondenti per gli utenti coinvolti nella sessione di messaggistica istantanea. I controlli verranno quindi eseguiti da Test-CsIM utilizzando i due utenti specificati.
-------------------------- Esempio 2 --------------------------
$cred1 = Get-Credential "litwareinc\pilar"
$cred2 = Get-Credential "litwareinc\kenmyer"
Test-CsIm -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\jhaas e litwareinc\davidegarghentini) sono in grado di accedere a Lync Server e quindi scambiare messaggi istantanei. 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 dell'oggetto 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 scambiare messaggi istantanei. Per ottenere questo risultato, viene utilizzato il cmdlet Test-CsIM con i seguenti parametri: TargetFqdn (il nome FQDN del pool di registrazione); SenderSipAddress (l'indirizzo SIP del primo utente di test); SenderCredential (l'oggetto Windows PowerShell contenente le credenziali di questo utente); -ReceiverSipAddress (l'indirizzo SIP dell'altro utente di test); ReceiverCredential (l'oggetto Windows PowerShell contenente le credenziali dell'altro utente).