Condividi tramite


Get-CsVoiceTestConfiguration

 

Ultima modifica dell'argomento: 2012-03-23

Recupera uno scenario di test utilizzabile per verificare i numeri di telefono rispetto a route e regole specificate.

Sintassi

Get-CsVoiceTestConfiguration [-Identity <XdsGlobalRelativeIdentity>] [-LocalStore <SwitchParameter>]

Get-CsVoiceTestConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>]

Descrizione dettagliata

Questo cmdlet recupera la route vocale, l'utilizzo, il dial plan e il criterio vocale rispetto ai quali verificare un numero di telefono specifico. 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 questa verifica recuperando una configurazione di test con questo cmdlet e quindi eseguendo tale scenario con il cmdlet Test-CsVoiceConfiguration.

Utenti autorizzati a eseguire il cmdlet: per impostazione predefinita, sono autorizzati a eseguire localmente il cmdlet Get-CsVoiceTestConfiguration i membri dei seguenti gruppi: RTCUniversalUserAdmins, 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 "Get-CsVoiceTestConfiguration"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Facoltativo

XdsGlobalRelativeIdentity

Una stringa che identifica in modo univoco la configurazione di test che si desidera recuperare.

Filter

Facoltativo

Stringa

Questo parametro fornisce un modo per effettuare una ricerca con caratteri jolly delle configurazioni di test vocali definite. Per informazioni dettagliate, vedere gli esempi più avanti in questo argomento.

LocalStore

Facoltativo

Parametro opzionale

Recupera la configurazione del test vocale dalla replica locale dell'archivio di gestione centrale anziché dall'archivio di gestione centrale stesso.

Tipi di input

Nessuno.

Tipi restituiti

Restituisce uno o più oggetti di tipo Microsoft.Rtc.Management.WritableConfig.Policy.Voice.TestConfiguration.

Esempio

-------------------------- Esempio 1 --------------------------

Get-CsVoiceTestConfiguration

Con questo esempio vengono recuperate tutte le impostazioni di configurazione di test vocale.

-------------------------- Esempio 2 --------------------------

Get-CsVoiceTestConfiguration | Select-Object Identity, DialedNumber, ExpectedTranslatedNumber

Con questo esempio vengono recuperate tutte le impostazioni di configurazione di test vocale e di ciascuna di esse viene visualizzato solo il parametro Identity, DialedNumber e ExpectedTranslatedNumber. Le impostazioni restituite da Get-CsVoiceTestConfiguration vengono inviate tramite pipe al cmdlet Select-Object dove l'output viene ristretto alle proprietà Identity, DialedNumber e ExpectedTranslatedNumber.

-------------------------- Esempio 3 --------------------------

Get-CsVoiceTestConfiguration -Filter *test*

In questo esempio viene utilizzato il parametro Filter per recuperare tutte le impostazioni di configurazione di test vocali con identità che contengono la stringa "test". I caratteri jolly (*) all'inizio e alla fine del valore di filtro indicano che la stringa "test" può essere posizionata in qualsiasi punto del valore Identity e può essere preceduta o seguita da un numero qualsiasi di caratteri. Ad esempio, il comando potrebbe restituire configurazioni di test vocali con nomi come TestConfig, VoiceNumberTest e VoiceTest1.