Condividi tramite

  • Articolo

Test-CsVoicePolicy

 

Ultima modifica dell'argomento: 2012-03-26

Consente di testare un numero telefonico rispetto a criteri vocali e determina quale route vocale utilizzare per quei criteri e per quel numero.

Sintassi

Test-CsVoicePolicy -TargetNumber <PhoneNumber> -VoicePolicy <VoicePolicy> [-Force <SwitchParameter>] [-RouteSettings <PstnRoutingSettings>]

Descrizione dettagliata

I criteri vocali sono legati alle route vocali tramite utilizzi PSTN (Public Switched Telephone Network). Una chiamata da un utente al quale sono stati assegnati particolari criteri vocali può essere inviata solo su una route in cui è disponibile un utilizzo PSTN corrispondente all'utilizzo nel criterio e con un formato del numero corrispondente al numero composto. Chiamare il cmdlet Test-CsVoicePolicy per determinare quale route verrà eventualmente utilizzata per instradare una chiamata proveniente da un utente con particolari criteri vocali, nonché quale utilizzo del telefono lega il criterio alla rete.

Utenti autorizzati a utilizzare questo cmdlet: per impostazione predefinita, il cmdlet Test-CsVoicePolicy 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-CsVoicePolicy"}

Parametri

Parametro Obbligatorio Tipo Descrizione

TargetNumber

Obbligatorio

PhoneNumber

Il numero di telefono su cui eseguire il test. Questo numero deve essere nel formato E.164 (come +14255551212).

Tipo di dati completi: Microsoft.Rtc.Management.Voice.PhoneNumber

VoicePolicy

Obbligatorio

VoicePolicy

Un riferimento ad un oggetto criterio vocale rispetto al quale eseguire il test. Per recuperare gli oggetti criterio vocale è possibile utilizzare il cmdlet Get-CsVoicePolicy.

Tipo di dati completi: Microsoft.Rtc.Management.WritableConfig.Policy.Voice.VoicePolicy

RouteSettings

Facoltativo

PstnRoutingSettings

Impostazioni della route sulla quale eseguire il test. Le impostazioni della route può essere recuperata utilizzando il cmdlet Get-CsRoutingConfiguration.

Tipo di dati completi: Microsoft.Rtc.Management.WritableConfig.Policy.Voice.PstnRoutingSettings

Force

Facoltativo

Parametro opzionale

Consente di evitare la visualizzazione di prompt di conferma o messaggi di errore non irreversibile che possono verificarsi quando si esegue il cmdlet.

Tipi di input

Oggetto Microsoft.Rtc.Management.WritableConfig.Policy.Voice.VoicePolicy. Accetta input tramite pipeline da oggetti criterio vocale.

Tipi restituiti

Restituisce un oggetto di tipo Microsoft.Rtc.Management.Voice.VoicePolicyTestResult.

Esempio

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

Get-CsVoicePolicy -Identity site:Redmond | Test-CsVoicePolicy -TargetNumber "+14255559999"

Questo esempio esegue un test sui criteri vocali del sito Identity:Redmond. Per prima cosa viene eseguito il cmdlet Get-CsVoicePolicy per recuperare i criteri con Identity site:Redmond. Tale oggetto criterio viene inviato tramite pipe al cmdlet Test-CsVoicePolicy che verifica il criterio per il numero telefonico +14255559999. L'output sarà la prima route (basta sulla proprietà Priority della route) con un formato numerico corrispondente al valore di TargetNumber ed un utilizzo telefonico che corrisponde a quello specificato nel criterio. Se non viene trovata una route corrispondente (ad esempio, se il formato del numero corrisponde ad un formato numero di 11 cifre e si fornisce un numero a 7 cifre) verrà restituito un valore nullo.

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

$a = Get-CsVoicePolicy -Identity site:Redmond
Test-CsVoicePolicy -TargetNumber "+14255559999" -VoicePolicy $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 per il parametro VoicePolicy per essere utilizzato come criterio di test.

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

Get-CsVoicePolicy | Test-CsVoicePolicy -TargetNumber "+12065559999"

Questo esempio esegue un test criteri vocali su tutti i criteri vocali definiti all'interno della distribuzione Lync Server 2010. Per prima cosa viene eseguito il cmdlet Get-CsVoicePolicy (senza parametri) per recuperare tutti i criteri vocali. La raccolta di criteri viene restituita e inviata tramite pipe al cmdlet Test-CsVoicePolicy che verifica ciascun criterio nella raccolta alla ricerca di una route corrispondente basata sul numero telefonico di destinazione fornito (+12065559999) e sull'utilizzo del telefono. L'output sarà un elenco di route corrispondenti assieme all'utilizzo del telefono di cui si è verificata la corrispondenza.