Test-CsPstnOutboundCall
Ultima modifica dell'argomento: 2012-03-26
Consente di verificare la capacità di un utente di effettuare una chiamata a un numero telefonico sulla rete PSTN (Public Switched Telephone Network).
Sintassi
Test-CsPstnOutboundCall -TargetFqdn <String> -TargetPstnPhoneNumber <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>] [-UserSipAddress <String>]
Test-CsPstnOutboundCall [-TargetFqdn <String>] -TargetPstnPhoneNumber <String> -UserCredential <PSCredential> -UserSipAddress <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>]
Descrizione dettagliata
Test-CsPstnOutboundCall è 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 i 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 sarà necessario fornire i nomi e le password di accesso di tutti gli utenti coinvolti.
Test-CsPstnOutboundCall può essere utilizzato anche in modalità piattaforma server. In quel caso è necessario solo specificare l'indirizzo SIP di un utente e Lync Server 2010 utilizzerà i certificati per autenticare l'utente.
Quando si esegue Test-CsPstnOutboundCall, il cmdlet tenta di eseguire l'accesso con l'account utente di test a Lync Server. Se l'accesso riesce, il cmdlet tenterà di effettuare una chiamata sul gateway PSTN. Questa chiamata telefonica verrà effettuata usando il dial plan, il criterio vocale e altri criteri e impostazioni assegnati all'account di test. Quando viene data risposta alla chiamata, il cmdlet invia codici di segnali multifrequenza (DTMF) sulla rete per verificare la connettività multimediale.
Nel corso del test, il cmdlet Test-CsPstnOutboundCall effettua una vera chiamata telefonica: il telefono di destinazione squillerà e sarà necessario rispondere affinché il test possa considerarsi riuscito. Questa chiamata deve essere terminata manualmente dall'amministratore.
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-CsPstnOutboundCall"}
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
TargetFqdn |
Obbligatorio |
Stringa |
Nome di dominio completo (FQDN) del pool da testare. |
TargetPstnPhoneNumber |
Obbligatorio |
Stringa |
Numero telefonico sulla rete PSTN da chiamare nel corso del test. Il numero telefonico di destinazione viene meglio specificato se si utilizza il formato E.164, ciò significa che il numero assomiglierà a questo "+14255551298", un numero che contiene il segno più (+) seguito dal prefisso internazionale (1), dal prefisso locale (425) e dal numero telefonico (5551298). Non utilizzare trattini, parentesi o altri caratteri quando si specifica il numero telefonico. Se non si utilizza il formato E.164, al numero telefonico verrà aggiunto il dial plan dell'utente. Lync Server 2010 utilizzerà quindi quel dial plan per normalizzare il numero nel formato E.164. Se il numero non può essere normalizzato non sarà possibile effettuare la chiamata ed il test avrà esito negativo. |
UserCredential |
Facoltativo |
Oggetto PSCredential |
Credenziali dell'utente titolare dell'account da sottoporre a test. Il valore specificato per il parametro UserCredential 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. Questo parametro non è necessario se il comando sta utilizzando gli utenti di test configurati con i cmdlet CsHealthMonitoringConfiguration. Non è necessario specificare questo parametro anche se si sta eseguendo il test in modalità piattaforma server. In tal caso, Lync Server 2010 tenterà di autenticare l'utente utilizzando i certificati. |
UserSipAddress |
Facoltativo |
Indirizzo SIP |
Indirizzo SIP dell'account utente da sottoporre a test. Ad esempio: -SenderSipAddress "sip:davidegarghentini@litwareinc.com". Il parametro UserSipAddress deve fare riferimento allo stesso account utente di UserCredential. Questo parametro non è necessario se il comando sta utilizzando gli utenti di test configurati con i cmdlet CsHealthMonitoringConfiguration. |
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. |
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. |
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-CsPstnOutboundCall non accetta input tramite pipeline.
Tipi restituiti
Test-CsPstnOutboundCall restituisce un'istanza dell'oggetto Microsoft.Rtc.SyntheticTransactions.TaskOutput.
Esempio
-------------------------- Esempio 1 --------------------------
Test-CsPstnOutboundCall -TargetFqdn atl-cs-001.litwareinc.com -TargetPstnPhoneNumber "+15551234567"
Nell'esempio precedente viene effettuato un controllo per verificare se un utente di test preconfigurato è in grado di accedere al pool atl-cs-001.litwareinc.com e quindi viene effettuata una chiamata sul gateway PSTN. 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 il primo utente di test può accedere al sistema e, in tal caso, chiamare un telefono sulla rete PSTN.
Se gli utenti di test non sono stati definiti, il comando avrà esito negativo in quanto non sarà in grado di stabilire con quali account utente effettuare il test. Se non è stato definito nessun utente di test per un pool, è necessario includere il parametro UserSipAddress e le credenziali per l'account utente coinvolto nel test. Test-CsPstnOutboundCall consentirà di eseguire la verifica utilizzando l'utente specificato.
-------------------------- Esempio 2 --------------------------
$cred1 = Get-Credential "litwareinc\kenmyer"
Test-CsPstnOutboundCall -TargetFqdn atl-cs-001.litwareinc.com -TargetPstnPhoneNumber "+15551234567" -UserSipAddress "sip:kenmyer@litwareinc.com" -UserCredential $cred1
I comandi riportati nell'Esempio 2 consentono di verificare se un utente di test (litwareinc\davidegarghentini) è in grado di accedere aLync Server e di effettuare una chiamata telefonica sul gateway PSTN. 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 Davide Garghentini. Dal momento che il nome di accesso litwareinc\davidegarghentini è 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 Davide Garghentini. L'oggetto credenziali risultante viene quindi memorizzato nella variabile denominata $cred1.
Disponendo dell'oggetto credenziali, il secondo comando nell'esempio consente di stabilire se l'utente di test è o meno in grado di accedere a Lync Server e quindi di effettuare una chiamata al numero telefonico di destinazione (+15551234567). Per eseguire questa operazione, viene utilizzato il cmdlet Test-CsPstnOutboundCall con i seguenti parametri: TargetFqdn (FQDN del pool di registrazione); UserSipAddress (l'indirizzo SIP dell'utente che deve effettuare la chiamata); UserCredential (l'oggetto Windows PowerShell contenente le credenziali dell'utente di test); TargetPstnPhoneNumber (il numero telefonico di destinazione).
-------------------------- Esempio 3 --------------------------
Test-CsPstnOutboundCall -TargetFqdn atl-cs-001.litwareinc.com -UserSipAddress sip:kenmyer@litwareinc.com -TargetPstnPhoneNumber "+15551234567"
L'Esempio 3 mostra come può essere utilizzato Test-CsPstnOutboundCall in modalità piattaforma server. In questa modalità, viene specificato l'indirizzo SIP ma non vengono incluse le credenziali utente. Nell'esecuzione in questa modalità, Lync Server 2010 utilizza i certificati per autenticare l'utente di test.