Test-CsVoiceTestConfiguration
Ultima modifica dell'argomento: 2012-03-26
Consente di eseguire configurazioni vocali di test per garantire che il routing e i criteri vocali funzionino come previsto.
Sintassi
Test-CsVoiceTestConfiguration -TestCaseInputObject <TestConfiguration> [-Dialplan <LocationProfile>] [-Force <SwitchParameter>] [-RouteSettings <PstnRoutingSettings>] [-VoicePolicy <VoicePolicy>]
Test-CsVoiceTestConfiguration -DialedNumber <PhoneNumber> -Dialplan <LocationProfile> -VoicePolicy <VoicePolicy> [-Force <SwitchParameter>] [-RouteSettings <PstnRoutingSettings>]
Descrizione dettagliata
Prima di implementare route vocali e criteri vocali, è buona norma testarli su diversi numeri di telefono per garantire che i risultati siano quelli previsti. L'esecuzione di questo cmdlet con le impostazioni di parametro appropriate consente di eseguire questi test.
Questo cmdlet consente di testare un numero di telefono rispetto alla route vocale, all'utilizzo, al dial plan e ai criteri vocali, per verificare i risultati desiderati o per confrontare il risultato effettivo con quello previsto. Le configurazioni vocali da testare possono essere definite immettendo i parametri appropriati individualmente oppure utilizzando il cmdlet New-CsVoiceTestConfiguration.
Se si immettono i valori per i parametri DialedNumber, DialPlan e VoicePolicy, l'output includerà il numero convertito, la regola di normalizzazione utilizzata per creare la conversione, la route utilizzata e l'utilizzo PSTN. Se invece si immette un valore per il parametro TestCaseInputObject, è possibile anche verificare se i risultati ottenuti corrispondono a quelli previsti specificati per l'oggetto test al momento della creazione con il cmdlet New-CsVoiceTestConfiguration.
Utenti autorizzati a utilizzare questo cmdlet: per impostazione predefinita, il cmdlet Test-CsVoiceTestConfiguration può essere utilizzato localmente dai membri dei seguenti gruppi: RTCUniversalServerAdmins. 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-CsVoiceTestConfiguration"}
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
DialedNumber |
Obbligatorio |
PhoneNumber |
Il numero di telefono su cui eseguire il test. Il numero viene normalizzato in base al dial plan, alla route e al criterio, quindi viene visualizzato come output. Questo parametro è obbligatorio, tranne nel caso in cui sia stato fornito un valore al parametro TestCaseInputObject. Non è possibile specificare sia DialedNumber sia TestCaseInputObject. (TestCaseInputObject contiene già un DialedNumber nell'oggetto). |
Dialplan |
Obbligatorio |
LocationProfile |
Un riferimento a un oggetto dial plan del dial plan da utilizzare durante l'esecuzione del test. Per recuperare questi oggetti dial plan è possibile utilizzare il cmdlet Get-CsDialPlan. Questo parametro è obbligatorio se è stato specificato anche il parametro DialedNumber. Non utilizzare questo parametro se si utilizza il parametro TestCaseInputObject. L'oggetto in questo parametro deve corrispondere al dial plan specificato in TestCaseInputObject, pertanto l'uso di questo parametro si rivela ridondante. |
TestCaseInputObject |
Obbligatorio |
TestConfiguration |
Un oggetto contenente un riferimento alla configurazione vocale da testare. Per recuperare questo riferimento oggetto è possibile utilizzare il cmdlet Get-CsVoiceTestConfiguration. Se si utilizza il cmdlet con questo parametro, non è possibile specificare DialedNumber. È preferibile non specificare nemmeno Dialplan o VoicePolicy, in quanto risulterebbero ridondanti rispetto ai valori nell'oggetto configurazione di test vocale. |
VoicePolicy |
Obbligatorio |
VoicePolicy |
Un riferimento a un oggetto criterio vocale del criterio vocale da utilizzare durante l'esecuzione del test. Per recuperare gli oggetti criterio vocale è possibile utilizzare il cmdlet Get-CsVoicePolicy. Questo parametro è obbligatorio se è stato specificato anche il parametro DialedNumber. Non utilizzare questo parametro se si utilizza il parametro TestCaseInputObject. L'oggetto in questo parametro deve corrispondere al criterio vocale specificato in TestCaseInputObject, pertanto l'uso di questo parametro si rivela ridondante. |
RouteSettings |
Facoltativo |
PstnRoutingSettings |
Un riferimento a un oggetto contenente tutte le route vocali disponibili nell'installazione di Microsoft Lync Server 2010. Per recuperare questo oggetto è possibile utilizzare il cmdlet Get-CsRoutingConfiguration. È possibile utilizzare questo parametro sia con il parametro DialedNumber sia con il parametro TestCaseInputObject. |
Force |
Facoltativo |
Parametro opzionale |
Consente di evitare la visualizzazione delle richieste di conferma che altrimenti verrebbero visualizzate prima che vengano apportate le modifiche. |
Tipi di input
Oggetto Microsoft.Rtc.Management.WritableConfig.Policy.Voice.TestConfiguration. Accetta l'input tramite pipeline di un oggetto configurazione di test vocale.
Tipi restituiti
Questo cmdlet restituisce un oggetto di tipo Microsoft.Rtc.Management.Voice.OcsVoiceTestResult.
Esempio
-------------------------- Esempio 1 --------------------------
Get-CsVoiceTestConfiguration -Identity TestConfig1 | Test-CsVoiceTestConfiguration
Con questo esempio viene eseguito un test della configurazione vocale TestConfig1. Per prima cosa viene eseguito il cmdlet Get-CsVoiceTestConfiguration per recuperare la configurazione con Identity TestConfig1. Tale oggetto di configurazione viene quindi inviato tramite pipe al cmdlet Test-CsVoiceTestConfiguration.
-------------------------- Esempio 2 --------------------------
$a = Get-CsVoiceTestConfiguration -Identity TestConfig1
Test-CsVoiceTestConfiguration -TestCaseInputObject $a
L'Esempio 2 è identico all'Esempio 1, tranne per il fatto che, invece di inviare tramite pipe i risultati dell'operazione Get direttamente al cmdlet Test, l'oggetto viene prima memorizzato nella variabile $a e successivamente viene fornito come valore del parametro TestCaseInputObject per essere utilizzato come configurazione di test.
-------------------------- Esempio 3 --------------------------
$dp = Get-CsDialPlan -Identity Global
$vp = Get-CsVoicePolicy -Identity Global
Test-CsVoiceTestConfiguration -DialedNumber 4255551212 -Dialplan $dp -VoicePolicy $vp
Con questo esempio viene eseguita una configurazione di test senza doverla prima definire con New-CsVoiceTestConfiguration. Invece di fornire un oggetto TestConfiguration creato in precedenza, in questo esempio viene mostrato come configurare un test "immediato" specificando il numero di telefono da testare, il dial plan e il criterio vocale su cui eseguire il test.
Nella prima riga dell'esempio viene utilizzato il cmdlet Get-CsDialPlan per recuperare il dial plan Global. L'oggetto dial plan recuperato viene assegnato alla variabile $dp. Nella seconda riga viene eseguita la stessa operazione con il criterio vocale, utilizzando il cmdlet Get-CsVoicePolicy per recuperare il criterio vocale Global e assegnarlo alla variabile $vp.
Infine, è possibile eseguire il test. Viene utilizzato il cmdlet Test-CsVoiceTestConfiguration, specificando il numero di telefono da testare per il parametro DialedNumber, il dial plan recuperato nella riga 1 (memorizzato in $dp) per il parametro Dialplan e il criterio vocale recuperato nella riga 2 (memorizzato in $vp) per il parametro VoicePolicy.
Si noti che l'output per l'Esempio 3 non includerà lo stato dei risultati previsti. Se si desidera confrontare i risultati ottenuti con quelli previsti, è necessario definire questi ultimi con il cmdlet New-CsVoiceTestConfiguration e quindi utilizzare il cmdlet Test-CsVoiceTestConfiguration come mostrato negli Esempi 1 e 2.