Test-CsPstnPeerToPeerCall
Ultima modifica dell'argomento: 2012-03-25
Consente di testare la capacità di condurre una chiamata peer-to-peer tra due utenti su un gateway di rete PSTN (Public Switched Telephone Network).
Sintassi
Test-CsPstnPeerToPeerCall -TargetFqdn <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-ReceiverSipAddress <String>] [-RegistrarPort <Nullable>] [-SenderSipAddress <String>]
Test-CsPstnPeerToPeerCall [-TargetFqdn <String>] -ReceiverCredential <PSCredential> -ReceiverSipAddress <String> -SenderCredential <PSCredential> -SenderSipAddress <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>]
Descrizione dettagliata
Test-CsPstnPeerToPeerCall è 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 le attività comuni quali l'accesso al sistema, lo scambio di messaggi istantanei o l'effettuazione di telefonate a un telefono appartenente alla rete PSTN (Public Switched Telephone Network). Tali verifiche possono essere condotte manualmente da un amministratore oppure possono essere eseguite 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 ciascuno dei propri pool di registrazione. Questi utenti di test sono una coppia di utenti preconfigurati per essere utilizzati nell'ambito delle transazioni sintetiche. Generalmente si tratta di account di test e non di account appartenenti a utenti effettivi. Quando vengono configurati gli utenti di test per un pool, gli amministratori possono eseguire una transazione sintetica su tale pool, senza dover specificare le identità degli account utente (e fornire le relative credenziali) 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 condurre una transazione sintetica utilizzando gli account utente reali, sarà necessario fornire i nomi di accesso e le password per ogni utente.
Test-CsPstnPeerToPeerCall può essere utilizzato anche nella modalità piattaforma server. In questo caso è sufficiente specificare l'indirizzo SIP degli utenti affinché Lync Server 2010 utilizzi i certificati per autenticare tali utenti.
Quando viene chiamato Test-CsPstnPeerToPeerCall, il cmdlet tenta per prima cosa di accedere ai due utenti di test su Lync Server. Supponendo che l'accesso riesca, il cmdlet fa sì che l'utente 1 tenti di chiamare l'utente 2 sul gateway PSTN; Test-CsPstnPeerToPeerCall effettua questa chiamata utilizzando il dial plan, il criterio vocale, gli altri criteri e le altre impostazioni di configurazione assegnati all'utente di test. Se il test procede come previsto, il cmdlet verifica che l'utente 2 sia in grado di rispondere alla chiamata, quindi disconnette entrambi gli account di test dal sistema.
Test-CsPstnPeerToPeerCall effettua una vera e propria chiamata telefonica, che verifica se sia possibile effettuare una connessione e trasmette codici DTMF sulla rete per determinare quali supporti possono essere inviati sulla connessione. Tuttavia, alla chiamata risponde il cmdlet stesso, pertanto non è necessaria una conclusione manuale della chiamata. In pratica, nessuno deve rispondere e riagganciare dal telefono chiamato.
Utenti che possono eseguire questo cmdlet: Per restituire un elenco di tutti i ruoli RBAC (Role-Based Access Control, controllo dell'accesso basato sui ruoli) a cui è stato assegnato questo cmdlet (compresi eventuali ruoli RBAC personalizzati creati autonomamente), eseguire il cmdlet riportato di seguito dal prompt di Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Test-CsPstnPeerToPeerCall"}
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
TargetFqdn |
Obbligatorio |
Stringa |
Nome di dominio completo del pool da testare. |
ReceiverCredential |
Facoltativo |
Oggetto credenziale PS |
Oggetto credenziali utente per il primo dei due account utente da testare. Il valore trasmesso a ReceiverCredential deve essere un riferimento oggetto ottenuto utilizzando il cmdlet Get-Credential. Ad esempio, il codice seguente restituisce un oggetto credenziali per l'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 richieste se si esegue il test con le impostazioni di configurazione di monitoraggio dello stato per il pool o se si esegue il test nella modalità piattaforma server. |
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 è richiesto se si esegue il test con le impostazioni di configurazione di monitoraggio dello stato per il 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 trasmesso a SenderCredential deve essere un riferimento 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 richieste se si esegue il test con le impostazioni di configurazione di monitoraggio dello stato per il pool o se si esegue il test nella modalità piattaforma server. |
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 è richiesto se si esegue il test con le impostazioni di configurazione di monitoraggio dello stato per il 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 segnalare l'attività dettagliata sullo schermo durante l'esecuzione del cmdlet. |
Tipi di input
Nessuno. Test-CsPstnPeerToPeerCall non accetta l'input da pipeline.
Tipi restituiti
Test-CsPstnPeerToPeerCall restituisce un'istanza dell'oggetto Microsoft.Rtc.SyntheticTransactions.TaskOutput.
Esempio
-------------------------- Esempio 1 --------------------------
Test-CsPstnPeerToPeerCall -TargetFqdn atl-cs-001.litwareinc.com
Con l'esempio precedente viene verificato se una coppia di utenti di test preconfigurati può accedere al pool atl-cs-001.litwareinc.com; dopo l'accesso degli utenti di test, Test-CsPstnPeerToPeerCall verifica se i due utenti stanno conducendo una chiamata peer-to-peer sul gateway PSTN. Il comando funziona soltanto se sono stati definiti utenti di test per il pool atl-cs-001.litwareinc.com. Se sono disponibili, il comando determina se il primo utente di test può accedere al sistema, quindi verifica se questo utente può chiamare il secondo utente definito per il pool.
Se non è stato definito un utente di test, il comando avrà esito negativo in quanto non sarà in grado di stabilire con quali utenti effettuare il test. Se non sono stati definiti gli utenti di test per un pool e se l'esecuzione non avviene in modalità piattaforma server, è necessario includere i parametri SenderSipAddress e ReceiverSipAddress e le credenziali corrispondenti per gli utenti che servono come account di test. I controlli verranno quindi eseguiti da Test-CsPstnPeerToPeerCall utilizzando i due utenti specificati.
-------------------------- Esempio 2 --------------------------
$cred1 = Get-Credential "litwareinc\pilar"
$cred2 = Get-Credential "litwareinc\kenmyer"
Test-CsPstnPeerToPeerCall -TargetFqdn atl-cs-001.litwareinc.com -SenderSipAddress "sip:jhaas@litwareinc.com" -SenderCredential $cred1 -ReceiverSipAddress "sip:kenmyer@litwareinc.com" -ReceiverCredential $cred2
Con i comandi mostrati nell'esempio 2 viene testata la capacità di una coppia di utenti (litwareinc\pilar e litwareinc\davidegarghentini) di accedere a Lync Server e di condurre una chiamata peer-to-peer sul gateway PSTN. A tal fine, il primo comando nell'esempio utilizza il cmdlet Get-Credential per creare un oggetto credenziali 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 soltanto che l'amministratore immetta la password per l'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 e condurre una chiamata peer-to-peer tramite il gateway PSTN. Per eseguire questa operazione viene chiamato Test-CsPstnPeerToPeerCall con i seguenti parametri: TargetFqdn (nome di dominio completo del pool di registrazione); SenderSipAddress (indirizzo SIP del primo utente di test); SenderCredential (oggetto Windows PowerShell contenente le credenziali per lo stesso utente); ReceiverSipAddress (indirizzo SIP per l'altro utente di test); ReceiverCredential (oggetto di Windows PowerShell contenente le credenziali per l'altro utente).
-------------------------- Esempio 3 --------------------------
Test-CsPstnPeerToPeerCall -TargetFqdn atl-cs-001.litwareinc.com -SenderSipAddress "sip:jhaas@litwareinc.com" -ReceiverSipAddress "sip:kenmyer@litwareinc.com"
Con l'esempio 3 viene mostrato come utilizzare Test-CsPstnPeerToPeerCall nella modalità piattaforma server. In questa modalità vengono specificati gli indirizzi SIP degli utenti di test, senza includere le credenziali utente. In questa modalità di esecuzione, Lync Server 2010 utilizza i certificati per autenticare i due utenti di test.