Test-CsP2PAV
Ultima modifica dell'argomento: 2012-03-26
Verifica se due utenti sono in grado di effettuare una chiamata audio/video (A/V) peer-to-peer.
Sintassi
Test-CsP2PAV -TargetFqdn <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-ReceiverSipAddress <String>] [-RegistrarPort <Nullable>] [-SenderSipAddress <String>]
Test-CsP2PAV [-TargetFqdn <String>] -ReceiverCredential <PSCredential> -ReceiverSipAddress <String> -SenderCredential <PSCredential> -SenderSipAddress <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>]
Descrizione dettagliata
Test-CsP2PAV è un esempio di "transazione sintetica" di Microsoft Lync Server 2010. Le transazioni sintetiche sono utilizzate in 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 limitarsi a 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. 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 (anziché una coppia di account di test) e provare 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.
Test-CsP2PAV viene utilizzato per determinare se due utenti di test sono in grado di partecipare a una conversazione audio/video (A/V) peer-to-peer. Per verificare questo scenario, il cmdlet inizia connettendo i due utenti a Lync Server. Presupponendo che i due accessi abbiano esito positivo, il primo utente invita quindi il secondo utente a partecipare a una chiamata A/V. Dopo che il secondo utente ha accettato la chiamata, viene testata la connessione tra i due utenti e quindi la chiamata viene terminata e gli utenti di test vengono disconnessi dal sistema.
Test-CsP2PAV non esegue effettivamente una chiamata A/V e non vengono scambiate informazioni multimediali tra gli utenti di test. Il cmdlet, viceversa, verifica semplicemente che sia possibile effettuare le connessioni appropriate e che i due utenti siano in grado di condurre tale chiamata.
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-CsP2PAV"}
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. |
Force |
Facoltativo |
Parametro opzionale |
Consente di non visualizzare i messaggi relativi agli errori non irreversibili che possono verificarsi durante l'esecuzione del comando. |
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. |
Verbose |
Facoltativo |
Parametro opzionale |
Consente di segnalare l'attività dettagliata sullo schermo durante l'esecuzione del cmdlet. |
Tipi di input
Nessuno. Test-CsP2PAV non accetta l'input da pipeline.
Tipi restituiti
Test-CsP2PAV restituisce un'istanza dell'oggetto Microsoft.Rtc.SyntheticTransactions.TaskOutput.
Esempio
-------------------------- Esempio 1 --------------------------
Test-CsP2PAV -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 effettuare una chiamata audio/video peer-to-peer. 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 e, in caso affermativo, se possono conversare utilizzando una chiamata audio/video.
Se non sono stati definiti utenti di test, il comando avrà esito negativo in quanto non sarà in grado di stabilire gli 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 messaggistica istantanea. Test-CsP2PAV effettuerà quindi i propri controlli utilizzando i due utenti specificati.
-------------------------- Esempio 2 --------------------------
$cred1 = Get-Credential "litwareinc\pilar"
$cred2 = Get-Credential "litwareinc\kenmyer"
Test-CsP2PAV -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 la capacità di una coppia di utenti (litwareinc\pilar e litwareinc\davidegarghentini) di accedere a Lync Server e di effettuare quindi una chiamata audio/video peer-to-peer. 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.
Con i due oggetti credenziali disponibili, il terzo comando dell'esempio determina se i due utenti possono accedere a Lync Server ed effettuare una chiamata audio/video peer-to-peer. Per eseguire questa attività, viene chiamato Test-CsP2PAV con i seguenti parametri: TargetFqdn (FQDN del pool di registrazione), SenderSipAddress (indirizzo SIP del primo utente di test), SenderCredential (oggetto Windows PowerShell contenente 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).