Test-CsAVConference
Ultima modifica dell'argomento: 2012-03-26
Testa la capacità di due utenti di partecipare a una conferenza audio/video (A/V).
Sintassi
Test-CsAVConference -TargetFqdn <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-ReceiverSipAddress <String>] [-RegistrarPort <Nullable>] [-SenderSipAddress <String>]
Test-CsAVConference [-TargetFqdn <String>] -ReceiverCredential <PSCredential> -ReceiverSipAddress <String> -SenderCredential <PSCredential> -SenderSipAddress <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>]
Descrizione dettagliata
Test-CsAVConference è un esempio di "transazione sintetica". Le transazioni sintetiche sono utilizzate in Microsoft Lync Server 2010 per verificare che gli utenti siano in grado di completare correttamente attività comuni quali l'accesso al sistema, lo scambio di messaggi istantanei o l'esecuzione di telefonate a un telefono appartenente alla rete PSTN (Public Switched Telephone Network). Tali verifiche possono essere effettuate manualmente da un amministratore oppure 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 ciascun pool di registrazione. Questi utenti di test sono una coppia di utenti preconfigurati per l'utilizzo con le transazioni sintetiche. Si tratta in genere di account di test e non di account appartenenti a utenti effettivi. Dopo aver configurato gli utenti di test per un pool, gli amministratori possono eseguire una transazione sintetica sul 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 account utente effettivi. Se ad esempio due utenti non sono in grado di scambiare messaggi istantanei, un amministratore può eseguire una transazione sintetica utilizzando i due account utente (anziché una coppia di account di test) e provare quindi a diagnosticare e risolvere il problema. Se si decide di eseguire una transazione sintetica utilizzando account utente effettivi, sarà necessario fornire i nomi e le password di accesso di ogni utente.
Il cmdlet Test-CsAVConference verifica se i due utenti di test sono in grado di eseguire una conferenza A/V. Quando viene eseguito il cmdlet, i due utenti vengono connessi al sistema. Dopo aver eseguito l'accesso, il primo utente crea una conferenza A/V e quindi attende che il secondo utente partecipi alla conferenza. Dopo un breve scambio di dati, la conferenza viene eliminata e i due utenti vengono disconnessi.
Test-CsAVConference non esegue effettivamente una conferenza A/V tra i due utenti di test. Il cmdlet piuttosto verifica che i due utenti possano creare le connessioni necessarie per effettuare tale conferenza.
Utenti autorizzati a eseguire il cmdlet: per restituire un elenco di tutti i ruoli RBAC (Role-Based Access Control) a cui è stato assegnato questo cmdlet, inclusi gli eventuali ruoli RBAC personalizzati creati dall'utente, dal prompt di Windows PowerShell eseguire il seguente comando:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Test-CsAVConference"}
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
TargetFqdn |
Obbligatorio |
Stringa |
Nome di dominio completo (FQDN) del pool da testare. |
ReceiverCredential |
Facoltativo |
Oggetto credenziale PS |
Oggetto credenziali utente per il primo dei due account utente da testare. Il valore passato a ReceiverCredential deve essere un riferimento a un oggetto ottenuto utilizzando il cmdlet Get-Credential. Il seguente codice ad esempio restituisce un oggetto credenziali dell'utente litwareinc\pilar e archivia tale oggetto in una variabile denominata $y: $y = Get-Credential "litwareinc\pilar" È necessario fornire la password utente quando si esegue questo comando. Le credenziali del destinatario non sono necessarie se si esegue il test con le impostazioni di configurazione per il monitoraggio dell'integrità del pool. |
ReceiverSipAddress |
Facoltativo |
Indirizzo SIP |
Indirizzo SIP del primo dei due account utente da testare. 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 esegue il test con le impostazioni di configurazione per il monitoraggio dell'integrità del pool. |
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. |
SenderCredential |
Facoltativo |
Oggetto credenziale PS |
Oggetto credenziali utente per il secondo dei due account utente da testare. Il valore passato a SenderCredential deve essere un riferimento a un 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. Le credenziali del mittente non sono necessarie se si esegue il test con le impostazioni di configurazione per il monitoraggio dell'integrità del pool. |
SenderSipAddress |
Facoltativo |
Indirizzo SIP |
Indirizzo SIP del secondo dei due account utente da testare. 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 esegue il test con le impostazioni di configurazione per il monitoraggio dell'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 non visualizzare i messaggi relativi agli errori non irreversibili che possono verificarsi durante l'esecuzione del comando. |
Verbose |
Facoltativo |
Parametro opzionale |
Consente di segnalare l'attività dettagliata sullo schermo durante l'esecuzione del cmdlet. |
Tipi di input
Nessuno.
Tipi restituiti
Test-CsAVConference restituisce un'istanza dell'oggetto Microsoft.Rtc.SyntheticTransactions.TaskOutput.
Esempio
-------------------------- Esempio 1 --------------------------
Test-CsAVConference -TargetFqdn atl-cs-001.litwareinc.com
Nell'esempio precedente viene verificato se una coppia di utenti di test preconfigurati può accedere al pool atl-cs-001.litwareinc.com e quindi partecipare a una conferenza A/V. Il comando funzionerà soltanto se sono stati definiti utenti di test per il pool atl-cs-001.litwareinc.com. In questo caso, il comando determinerà se i due utenti possono accedere al sistema. In caso affermativo, il primo utente di test crea una conferenza A/V e invita il secondo utente a partecipare. Il cmdlet verificherà quindi se i due utenti di test sono stati in grado o meno di effettuare una connessione.
Se non sono stati definiti utenti di test, il comando avrà esito negativo in quanto non sarà in grado di stabilire l'account utente da utilizzare per effettuare il test. Se non sono stati definiti utenti di test per un pool, sarà necessario includere i parametri SenderSipAddress e ReceiverSipAddress, nonché le credenziali corrispondenti per gli utenti coinvolti nello scambio di messaggi istantanei. Test-CsAVConference effettuerà quindi le verifiche utilizzando i due utenti specificati.
-------------------------- Esempio 2 --------------------------
$cred1 = Get-Credential "litwareinc\pilar"
$cred2 = Get-Credential "litwareinc\kenmyer"
Test-CsAVConference -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 verificano se due utenti (litwareinc\pilar e litwareinc\davidegarghentini) sono in grado di accedere a Lync Server 2010 e quindi partecipare a una conferenza A/V. A tale scopo, nel primo comando riportato nell'esempio viene utilizzato il cmdlet Get-Credential per creare un oggetto credenziali di Windows PowerShell contenente il nome e la password dell'utente Luisa Cazzaniga. Poiché il nome di accesso litwareinc\pilar è stato incluso come parametro, la finestra di dialogo Richiesta credenziali di Windows PowerShell richiede esclusivamente che l'amministratore immetta la password dell'account Luisa Cazzaniga. L'oggetto credenziali risultante viene memorizzato in una variabile denominata $cred1. Il secondo comando effettua la stessa operazione, questa volta restituendo un oggetto credenziali per l'account Davide Garghentini.
Disponendo dei due oggetti credenziali, il terzo comando riportato nell'esempio stabilisce se i due utenti sono o meno in grado di accedere a Lync Server 2010 e quindi di partecipare a una conferenza A/V. Per eseguire questa attività, viene chiamato Test-CsAVConference con i seguenti parametri: TargetFqdn (FQDN del pool di registrazione), SenderSipAddress (indirizzo SIP del primo utente di test), SenderCredential (oggetto Windows PowerShell contenete le credenziali di questo stesso utente), ReceiverSipAddress (indirizzo SIP dell'altro utente di test) e ReceiverCredential (oggetto Windows PowerShell contenente le credenziali dell'altro utente).