Test-CsDialInConferencing
Ultima modifica dell'argomento: 2012-03-25
Test-CsDialInConferencing verifica se un utente può partecipare a una sessione di una conferenza telefonica con accesso esterno.
Sintassi
Test-CsDialInConferencing -TargetFqdn <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>] [-UserSipAddress <String>]
Test-CsDialInConferencing [-TargetFqdn <String>] -UserCredential <PSCredential> -UserSipAddress <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>]
Descrizione dettagliata
Test-CsDialInConferencing è un esempio di "transazione sintetica" di Microsoft Lync Server 2010. Le transazioni sintetiche vengono utilizzate in Lync Server 2010 per verificare che gli utenti siano in grado di effettuare correttamente attività comuni quali l'accesso al sistema, lo scambio di messaggi istantanei o l'esecuzione di chiamate a un telefono appartenente alla rete PSTN (Public Switched Telephone Network). Tali verifiche possono essere svolte "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 pool di registrazione. Questi utenti di test sono coppie 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. Con gli utenti di test configurati per un pool, gli amministratori possono semplicemente eseguire una transazione sintetica su tale pool senza dover specificare le identità (e fornire le credenziali) degli account utente coinvolti nella verifica.
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 per ogni utente.
Test-CsDialInConferencing funziona tentando di connettere un utente di test al sistema. Se si utilizzano utenti di test, Test-CsDialInConferencing utilizzerà il primo account di test configurato per il pool. Se l'accesso riesce, il cmdlet consente di utilizzare le credenziali e le autorizzazioni dell'utente per verificare i numeri di accesso disponibili alla conferenza telefonica con accesso esterno. La corretta esecuzione o la mancata riuscita di ciascun tentativo di accesso verrà registrata, quindi l'utente di test verrà disconnesso da Lync Server.
Test-CsDialInConferencing verifica soltanto che sia possibile effettuare le connessioni appropriate. Con il cmdlet non vengono infatti effettuate chiamate telefoniche né create conferenze telefoniche con accesso esterno a cui possano partecipare altri utenti.
Utenti autorizzati a eseguire il cmdlet: per impostazione predefinita, sono autorizzati a eseguire localmente il cmdlet Test-CsDialInConferencing i membri dei seguenti gruppi: RTCUniversalServerAdmins. 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-CsDialInConferencing"}
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
TargetFqdn |
Obbligatorio |
Stringa |
Il nome di dominio completo (FQDN) del pool da verificare. |
UserCredential |
Obbligatorio |
Oggetto credenziale PS |
l'oggetto credenziale utente per l'account utente che deve essere verificato. Il valore passato a UserCredential 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. Questo parametro non è necessario se si esegue la verifica utilizzando le impostazioni di configurazione del monitoraggio dell'integrità. |
UserSipAddress |
Obbligatorio |
Indirizzo SIP |
l'indirizzo SIP dell'account utente che deve essere verificato. Ad esempio: -UserSipAddress "sip:davidegarghentini@litwareinc.com". Il parametro UserSipAddress deve fare riferimento allo stesso account utente di UserCredential. Questo parametro non è necessario se si esegue la verifica utilizzando le impostazioni di configurazione del monitoraggio dell'integrità. |
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 |
La porta SIP utilizzata dal servizio di registrazione. Questo parametro non è obbligatorio se il servizio di registrazione utilizza la porta 5061 predefinita. |
Verbose |
Facoltativo |
Parametro opzionale |
Consente di segnalare l'attività dettagliata sullo schermo durante l'esecuzione del cmdlet. |
Force |
Facoltativo |
Parametro opzionale |
Consente di non visualizzare i messaggi relativi agli errori non irreversibili che possono verificarsi durante l'esecuzione del comando. |
Tipi di input
Nessuno. Test-CsDialInConferencing non accetta l'input da pipeline.
Tipi restituiti
Test-CsDialInConferencing restituisce un'istanza dell'oggetto Microsoft.Rtc.SyntheticTransactions.TaskOutput.
Esempio
-------------------------- Esempio 1 --------------------------
Test-CsDialInConferencing -TargetFqdn atl-cs-001.litwareinc.com
l'esempio riportato sopra consente di verificare se un utente di test preconfigurato può unirsi a una conferenza telefonica con accesso esterno sul pool atl-cs-001.litwareinc.com. Il comando funzionerà soltanto se sono stati definiti utenti di test per il pool atl-cs-001.litwareinc.com. In caso affermativo, il comando stabilirà se il primo utente di test è o meno in grado di accedere a Lync Server.
Se non sono stati definiti utenti di test, il comando avrà esito negativo, in quanto non sarà in grado di stabilire con quale utente tentare di eseguire l'accesso. Se non sono stati definiti utenti di test per un pool, sarà necessario includere il parametro UserCredential e le credenziali dell'utente che devono essere utilizzate dal comando per tentare di eseguire l'accesso.
-------------------------- Esempio 2 --------------------------
$cred1 = Get-Credential "litwareinc\pilar"
Test-CsDialInConferencing -TargetFqdn atl-cs-001.litwareinc.com -UserSipAddress "sip:pilar@litwareinc.com" -UserCredential $cred1
I comandi mostrati nell'esempio 2 verificano la capacità di un utente specifico (litwareinc\pilar) di partecipare a una conferenza telefonica con accesso esterno sul pool atl-cs-001.litwareinc.com. A tale scopo, nel primo comando dell'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, l'amministratore deve solo immettere la password dell'account di Luisa Cazzaniga nella finestra di dialogo Richiesta credenziali di Windows PowerShell. l'oggetto credenziali risultante viene memorizzato in una variabile denominata $cred1.
Il secondo comando quindi verifica se l'utente Luisa Cazzaniga può accedere al pool atl-cs-001.litwareinc.com e partecipare a una conferenza telefonica con accesso esterno. Per eseguire questa attività, viene chiamato Test-CsDialInConferencing con tre parametri, ovvero TargetFqdn (il nome di dominio completo del pool di registrazione), UserCredential (l'oggetto di Windows PowerShell contenente le credenziali utente di Luisa Cazzaniga) e UserSipAddress (l'indirizzo SIP corrispondente alle credenziali utente fornite).