Test-CsPresence
Ultima modifica dell'argomento: 2012-03-26
Consente di testare l'abilità di un utente ad accedere a Microsoft Lync Server 2010, pubblicare le proprie informazioni sulla presenza e sottoscrivere le informazioni sulla presenza pubblicate da un secondo utente.
Sintassi
Test-CsPresence -TargetFqdn <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-PublisherSipAddress <String>] [-RegistrarPort <Nullable>] [-SubscriberSipAddress <String>] [-SubscriberSipAddress <String>]
Test-CsPresence [-TargetFqdn <String>] -PublisherCredential <PSCredential> -PublisherSipAddress <String> -SubscriberCredential <PSCredential> -SubscriberSipAddress <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>] [-SubscriberSipAddress <String>]
Descrizione dettagliata
Test-CsPresence è 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. Generalmente, si tratta di account di test che non appartengono a utenti reali. Dopo aver configurato questi account utente per un pool, gli amministratori possono semplicemente eseguire una transazione sintetica su quel pool senza dover specificare le identità e 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.
Test-CsPresence viene utilizzato per determinare se una coppia di utenti di test è in grado di accedere a Lync Server e quindi di scambiarsi informazioni sulla presenza. Per ottenere questo risultato il cmdlet deve far accedere i due utenti al sistema. Se entrambi gli accessi riescono il primo utente di prova chiede di ricevere le informazioni sulla presenza dal secondo utente. Il secondo utente pubblica queste informazioni e Test-CsPresence verifica che le informazioni vengano correttamente trasmesse al primo utente. Dopo lo scambio delle informazioni sulla presenza i due utenti di test vengono scollegati da Lync Server.
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-CsPresence"}
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
TargetFqdn |
Obbligatorio |
Stringa |
Nome di dominio completo (FQDN) del pool da testare. |
PublisherCredential |
Obbligatorio |
Oggetto PSCredential |
L'oggetto credenziali utente per il primo dei due account utente da testare. Il valore specificato per il parametro PublisherCredential 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 di pubblicazione non sono necessarie se si sta eseguendo il test con le impostazioni di configurazione per il monitoraggio dello stato di integrità del pool. |
PublisherSipAddress |
Obbligatorio |
Indirizzo SIP |
L'indirizzo SIP per il primo dei due account utente da testare. Ad esempio: -PublisherSipAddress "sip:davidegarghentini@litwareinc.com". Il parametro PublisherSipAddress deve fare riferimento allo stesso account utente di PublisherCredential. 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. |
SubscriberCredential |
Obbligatorio |
Oggetto PSCredential |
L'oggetto credenziali utente per il secondo dei due account utente da testare. Il valore specificato per il parametro SubscriberCredential 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 di sottoscrittore non sono necessarie se si sta eseguendo il test con le impostazioni di configurazione per il monitoraggio dello stato di integrità del pool. |
SubscriberSipAddress |
Obbligatorio |
Indirizzo SIP |
L'indirizzo SIP del secondo dei due account utente da testare. Ad esempio: -SubscriberSipAddress "sip:pilar@litwareinc.com". Il parametro SubscriberSipAddress deve fare riferimento allo stesso account utente di SubscriberCredential. 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. |
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 |
Stringa |
Consente di visualizzare sullo schermo informazioni dettagliate sull'attività del cmdlet in esecuzione. |
Tipi di input
Nessuno. Test-CsPresence non accetta input tramite pipeline.
Tipi restituiti
Test-CsPresence restituisce un'istanza dell'oggetto Microsoft.Rtc.SyntheticTransactions.TaskOutput.
Esempio
-------------------------- Esempio 1 --------------------------
Test-CsPresence -TargetFqdn atl-cs-001.litwareinc.com
Nell'esempio precedente viene effettuato un controllo per stabilire se una coppia di utenti di test preconfigurati è in grado di accedere al pool atl-cs-001.litwareinc.com; dopo l'accesso, il cmdlet Test-CsPresence verifica se i due utenti sono in grado di scambiare le informazioni sulla presenza. 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 determinerà se il primo utente di test è in grado di accedere al sistema, quindi verificherà se è in grado di scambiare informazioni sulla presenza con il secondo utente di test definito per il pool.
Se non è stato definito un servizio Registrazione avanzata, il comando avrà esito negativo in quanto non sarà in grado di stabilire con quale account utente effettuare il test. Se non sono stati definiti gli utenti di test per un pool, è necessario includere i parametri SubscriberSipAddress e PublisherSipAddress oltre alle credenziali corrispondenti per gli utenti che fungono da sottoscrittore della presenza ed entità di pubblicazione della presenza. I controlli verranno quindi eseguiti da Test-CsPresence utilizzando i due utenti specificati.
-------------------------- Esempio 2 --------------------------
$cred1 = Get-Credential "litwareinc\pilar"
$cred2 = Get-Credential "litwareinc\kenmyer"
Test-CsPresence -TargetFqdn atl-cs-001.litwareinc.com -SubscriberSipAddress "sip:pilar@litwareinc.com" -SubscriberCredential $cred1 -PublisherSipAddress "sip:kenmyer@litwareinc.com" -PublisherCredential $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 di scambiarsi 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 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 di scambiarsi le informazioni sulla presenza. Per eseguire questa operazione, viene utilizzato il cmdlet Test-CsPresence con i seguenti parametri: TargetFqdn (il nome FQDN del pool di registrazione); SubscriberSipAddress (l'indirizzo SIP del primo utente di test); SubscriberCredential (l'oggetto Windows PowerShell contenente le credenziali di questo stesso utente); PublisherSipAddress (l'indirizzo SIP dell'altro utente di test); PublisherCredential (l'oggetto Windows PowerShell contenente le credenziali dell'altro utente).