New-CsVoiceTestConfiguration
Ultima modifica dell'argomento: 2012-03-27
Consente di creare uno scenario di test utilizzabile per testare i numeri di telefono rispetto a route e regole specificate.
Sintassi
New-CsVoiceTestConfiguration -Identity <XdsGlobalRelativeIdentity> [-Confirm [<SwitchParameter>]] [-DialedNumber <String>] [-ExpectedRoute <String>] [-ExpectedTranslatedNumber <String>] [-ExpectedUsage <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-TargetDialplan <String>] [-TargetVoicePolicy <String>] [-WhatIf [<SwitchParameter>]]
New-CsVoiceTestConfiguration -Name <String> [-Confirm [<SwitchParameter>]] [-DialedNumber <String>] [-ExpectedRoute <String>] [-ExpectedTranslatedNumber <String>] [-ExpectedUsage <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-TargetDialplan <String>] [-TargetVoicePolicy <String>] [-WhatIf [<SwitchParameter>]]
Descrizione dettagliata
Prima di implementare route vocali e criteri vocali, è opportuno testarli su diversi numeri di telefono per garantire che i risultati siano quelli previsti. È possibile eseguire questi test creando scenari di prova con questo cmdlet.
Il cmdlet New-CsVoiceTestConfiguration definisce la route vocale, l'utilizzo, il dial plan e il criterio vocale su cui testare un numero di telefono specificato. Tutte queste informazioni possono essere definite e recuperate utilizzando altri cmdlet. Per ulteriori dettagli, vedere le descrizioni dei parametri di questo argomento.
Per testare le configurazioni create con questo cmdlet è possibile utilizzare il cmdlet Test-CsVoiceTestConfiguration.
Utenti autorizzati a eseguire il cmdlet: per impostazione predefinita, sono autorizzati a eseguire localmente il cmdlet New-CsVoiceTestConfiguration 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 "New-CsVoiceTestConfiguration"}
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
Identity |
Obbligatorio |
XdsGlobalRelativeIdentity |
Una stringa che identifica in modo univoco questo scenario di test. Questa stringa può essere lunga fino a 32 caratteri e può contenere caratteri alfanumerici oltre alla barra rovesciata (\), il punto (.) o il carattere di sottolineatura (_). Il valore di questo parametro non include l'ambito perché l'oggetto può essere creato solo con ambito globale. Di conseguenza è richiesto solamente un nome univoco. |
Name |
Obbligatorio |
Stringa |
Questo parametro contiene lo stesso valore del parametro Identity. Se il parametro Identity è specificato, non è possibile includere il parametro Name nel comando. Allo stesso modo, se il parametro Name è specificato, non è possibile specificare il parametro Identity. |
DialedNumber |
Facoltativo |
Stringa |
Il numero di telefono da utilizzare per testare criteri, utilizzi e così via. Deve contenere al massimo 512 caratteri. Valore predefinito: 1234 |
ExpectedRoute |
Facoltativo |
Stringa |
Il nome della route vocale che si prevede di utilizzare durante il test di configurazione. Se si utilizza una route diversa, basata sul criterio vocale e sul dial plan di destinazione, il test non riuscirà. Per recuperare le route vocali disponibili è possibile chiamare il cmdlet Get-CsVoiceRoute. Deve contenere al massimo 256 caratteri. |
ExpectedTranslatedNumber |
Facoltativo |
Stringa |
Il numero di telefono nel formato che si prevede di voler visualizzare dopo la conversione. È il valore del parametro DialedNumber dopo la normalizzazione. Se si esegue Test-CsVoiceTestConfiguration e DialedNumber non risulta uguale al valore in ExpectedTranslatedNumber, il risultato del test sarà negativo (Fail). Deve contenere al massimo 512 caratteri. Valore predefinito: +1234 |
ExpectedUsage |
Facoltativo |
Stringa |
Il nome dell'utilizzo PSTN che si prevede di utilizzare durante il test di configurazione. Se si adopera un utilizzo PSTN diverso, basato sul criterio vocale e sul dial plan di destinazione, il test non riuscirà. Per recuperare gli utilizzi disponibili, richiamare il cmdlet Get-CsPstnUsage. Deve contenere al massimo 256 caratteri. |
TargetDialplan |
Facoltativo |
Stringa |
L'identità del dial plan da utilizzare per questo test. Per recuperare i dial plan, chiamare il cmdlet Get-CsDialPlan. Deve contenere al massimo 40 caratteri. Valore predefinito: Global |
TargetVoicePolicy |
Facoltativo |
Stringa |
L'identità del criterio vocale su cui eseguire il test. Per recuperare i criteri vocali è possibile chiamare il cmdlet Get-CsVoicePolicy. Deve contenere al massimo 40 caratteri. Valore predefinito: Global |
Force |
Facoltativo |
Parametro opzionale |
Elimina qualsiasi richiesta di conferma che, in caso contrario, sarebbe visualizzata prima di effettuare le modifiche. |
InMemory |
Facoltativo |
Parametro opzionale |
Crea un riferimento a un oggetto senza eseguire realmente il commit dell'oggetto come modifica permanente. Se si assegna l'output del cmdlet chiamato con questo parametro a una variabile, è possibile apportare modifiche alle proprietà del riferimento all'oggetto e quindi eseguire il commit di queste modifiche chiamando il cmdlet Set- corrispondente. |
WhatIf |
Facoltativo |
Parametro opzionale |
Descrive ciò che accadrebbe se si eseguisse il comando senza eseguirlo realmente. |
Confirm |
Facoltativo |
Parametro opzionale |
Viene visualizzata una richiesta di conferma prima di eseguire il comando. |
Tipi di input
Nessuno.
Tipi restituiti
Questo cmdlet crea un oggetto di tipo Microsoft.Rtc.Management.WritableConfig.Policy.Voice.TestConfiguration
Esempio
-------------------------- Esempio 1 --------------------------
New-CsVoiceTestConfiguration -Identity TestConfig1
In questo esempio viene creata una nuova configurazione di test vocale con valori predefiniti, la cui identità è TestConfig1.
-------------------------- Esempio 2 --------------------------
New-CsVoiceTestConfiguration TestConfig1 -TargetDialplan site:Redmond1
In questo esempio viene creata una nuova configurazione di test vocale denominata TestConfig1 e il parametro TargetLocationProfile viene impostato su site:Redmond1. Ciò consentirà di testare il numero, l'utilizzo e la route previsti utilizzando le impostazioni del dial plan per il sito Redmond1.
In questo esempio TestConfig1 viene dichiarata senza specificare il parametro Identity. Il parametro Identity è di tipo posizionale, per cui il primo valore del comando che segue il nome del cmdlet viene riconosciuto dal cmdlet come identità.
-------------------------- Esempio 3 --------------------------
New-CsVoiceTestConfiguration -Identity TestConfig1 -DialedNumber 5551212 -ExpectedTranslatedNumber +5551212
In questo esempio viene creata una nuova configurazione di test vocale denominata TestConfig1. Questa configurazione utilizzerà i valori predefiniti per testare il parametro DialedNumber 5551212 su un output previsto (ExpectedTranslatedNumber) di +5551212. La previsione si basa sulle regole di normalizzazione associate al dial plan che verrà utilizzato quando verrà eseguito un test su questo oggetto. Il test deve essere eseguito utilizzando il cmdlet Test-CsVoiceTestConfiguration.