Set-CsVoiceTestConfiguration
Ultima modifica dell'argomento: 2012-03-27
Consente di modificare uno scenario di test utilizzabile per testare i numeri di telefono rispetto a route e regole specificate.
Sintassi
Set-CsVoiceTestConfiguration [-Identity <XdsGlobalRelativeIdentity>] [-Confirm [<SwitchParameter>]] [-DialedNumber <String>] [-ExpectedRoute <String>] [-ExpectedTranslatedNumber <String>] [-ExpectedUsage <String>] [-Force <SwitchParameter>] [-TargetDialplan <String>] [-TargetVoicePolicy <String>] [-WhatIf [<SwitchParameter>]]
Set-CsVoiceTestConfiguration [-Confirm [<SwitchParameter>]] [-DialedNumber <String>] [-ExpectedRoute <String>] [-ExpectedTranslatedNumber <String>] [-ExpectedUsage <String>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-TargetDialplan <String>] [-TargetVoicePolicy <String>] [-WhatIf [<SwitchParameter>]]
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. Per farlo è possibile modificare gli scenari di test con questo cmdlet.
Il cmdlet Set-CsVoiceTestConfiguration consente di modificare la route vocale, l'utilizzo, il profilo di località, il profilo di numerazione locale (dial plan) e il criterio vocale rispetto a cui testare un numero di telefono specificato. Tutte queste informazioni possono essere definite e recuperate utilizzando altri cmdlet, come specificato nelle descrizioni dei parametri per questo argomento.
Per testare le configurazioni modificate con questo cmdlet è possibile utilizzare il cmdlet Test-CsVoiceTestConfiguration.
Utenti autorizzati a utilizzare questo cmdlet: per impostazione predefinita, il cmdlet Set-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 "Set-CsVoiceTestConfiguration"}
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
Identity |
Facoltativo |
Stringa |
Una stringa che identifica in modo univoco lo scenario di test da modificare. Il valore di questo parametro non include l'ambito perché l'oggetto può essere creato solo con ambito globale. Di conseguenza è richiesto solo il nome. |
Instance |
Facoltativo |
TestConfiguration |
Un oggetto di tipo Microsoft.Rtc.Management.WritableConfig.Policy.Voice.TestConfiguration che contiene una configurazione di test vocale esistente con le modifiche che si desidera apportare a tale configurazione. Un oggetto di questo tipo può essere recuperato utilizzando il cmdlet Get-CsVoiceTestConfiguraton. |
DialedNumber |
Facoltativo |
Stringa |
Il numero di telefono da utilizzare per testare criteri, utilizzi e così via. Deve contenere al massimo 512 caratteri. |
ExpectedRoute |
Facoltativo |
Stringa |
Il nome della route vocale che si prevede di utilizzare durante il test di configurazione. Se viene utilizzata una route diversa, basata sul dial plan di destinazione e sul criterio vocale, il test non riesce. Per recuperare le route vocali disponibili, utilizzare il cmdlet Get-CsVoiceRoute. Deve contenere al massimo 256 caratteri. |
ExpectedTranslatedNumber |
Facoltativo |
Stringa |
Il numero di telefono nel formato che si desidera 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à Fail. Deve contenere al massimo 512 caratteri. |
ExpectedUsage |
Facoltativo |
Stringa |
Il nome dell'utilizzo PSTN che si prevede di utilizzare durante il test di configurazione. Se viene utilizzato un diverso utilizzo PSTN, basata sul dial plan di destinazione e sul criterio vocale, il test non riesce. Per recuperare gli utilizzi disponibili, utilizzare il cmdlet Get-CsPstnUsage. Deve contenere al massimo 256 caratteri. |
TargetDialplan |
Facoltativo |
Stringa |
L'identità del dial plan da utilizzare per il test. Per recuperare i dial plan, utilizzare il cmdlet Get-CsDialPlan. Deve contenere al massimo 40 caratteri. |
TargetVoicePolicy |
Facoltativo |
Stringa |
L'identità del criterio vocale su cui eseguire il test. Per recuperare i criteri vocali, utilizzare il cmdlet Get-CsVoicePolicy. Deve contenere al massimo 40 caratteri. |
Force |
Facoltativo |
Parametro opzionale |
Consente di evitare la visualizzazione delle richieste di conferma che altrimenti verrebbero visualizzate prima che vengano apportate le modifiche. |
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
Oggetto Microsoft.Rtc.Management.WritableConfig.Policy.Voice.TestConfiguration. Accetta l'input tramite pipeline di oggetti configurazione di test vocale.
Tipi restituiti
Questo cmdlet restituisce un oggetto di tipo Microsoft.Rtc.Management.WritableConfig.Policy.Voice.TestConfiguration.
Esempio
-------------------------- Esempio 1 --------------------------
Set-CsVoiceTestConfiguration -Identity TestConfig1 -DialedNumber 14255551212
Con questo esempio il numero composto della configurazione di test vocale per TestConfig1 viene impostato su 14255551212. È il numero che verrà controllato rispetto al criterio vocale e alla route per garantire che la normalizzazione avvenga come previsto e per garantire l'applicazione delle route e dei dial plan corretti.
-------------------------- Esempio 2 --------------------------
Set-CsVoiceTestConfiguration -Identity TestConfig1 -TargetDialplan site:Redmond1 -ExpectedTranslatedNumber "+912065551212"
Con questo esempio vengono modificate le impostazioni per la configurazione di test vocale TestConfig1. Il comando imposta TargetDialplan sul dial plan per site:Redmond1. Dal momento che una modifica al dial plan comporta un cambiamento nelle regole di normalizzazione, è stato modificato anche ExpectedTranslationNumber per riflettere quanto ci si aspetta dalle regole di normalizzazione per tale dial plan.