Condividi tramite

  • Articolo

Set-CsVoiceConfiguration

 

Ultima modifica dell'argomento: 2012-03-26

Modifica un elenco di configurazioni di test vocali.

Sintassi

Set-CsVoiceConfiguration [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-VoiceTestConfigurations <PSListModifier>] [-WhatIf [<SwitchParameter>]]

Set-CsVoiceConfiguration [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-VoiceTestConfigurations <PSListModifier>] [-WhatIf [<SwitchParameter>]]

Descrizione dettagliata

Le configurazioni di test vocali sono utilizzate per testare un numero di telefono a fronte di criteri vocali, route e dial plan specifici. Questo cmdlet può essere utilizzato per modificare le configurazioni di test vocali da un elenco contenente tutte le configurazioni di test vocali per una distribuzione di Microsoft Lync Server 2010.

Questo cmdlet modifica un oggetto di tipo VoiceConfiguration. Questo oggetto è semplicemente un oggetto contenitore per configurazioni di test vocali. Pertanto, l'uso di questo cmdlet non è consigliato. Per modificare le configurazioni vocali, modificare le singole configurazioni di test vocale chiamando il cmdletSet-CsVoiceTestConfiguration.

Utenti autorizzati a eseguire il cmdlet: per impostazione predefinita, sono autorizzati a eseguire localmente il cmdlet Set-CsVoiceConfiguration 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 "Set-CsVoiceConfiguration"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Facoltativo

Stringa

L'ambito di questo oggetto. L'unico valore possibile per questo parametro è Global.

Instance

Facoltativo

VoiceConfiguration

Un riferimento per un oggetto configurazione vocale (Microsoft.Rtc.Management.WritableConfig.Policy.Voice.VoiceConfiguration). Un oggetto di questo tipo può essere recuperato chiamando il cmdlet Get-CsVoiceConfiguration.

VoiceTestConfigurations

Facoltativo

PSListModifier

Un elenco di tutte le configurazioni di test vocali (oggetti Microsoft.Rtc.Management.WritableConfig.Policy.Voice.TestConfiguration) definite per la distribuzione di Lync Server 2010.

È possibile modificare i singoli oggetti di configurazione di test vocale utilizzando il cmdlet Set-CsVoiceTestConfiguration. Questa è la modalità consigliata per modificare le configurazioni in questo elenco.

Force

Facoltativo

Parametro opzionale

Elimina qualsiasi richiesta di conferma che, in caso contrario, sarebbe visualizzata prima di effettuare 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.VoiceConfiguration. Accetta l'input da pipeline di un oggetto di configurazione vocale.

Tipi restituiti

Set-CsVoiceConfiguration non restituisce un valore o un oggetto. Il cmdlet piuttosto configura le istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Policy.Voice.VoiceConfiguration.

Esempio

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

$a = Get-CsVoiceConfiguration
$b = $a.VoiceTestConfigurations | Where-Object {$_.Name -eq "TestConfig2"}
$b.DialedNumber = 5551212
$b.ExpectedTranslatedNumber = +5551212
Set-CsVoiceConfiguration -Instance $a

Per modificare una configurazione di test vocale all'interno di una configurazione vocale sono necessari diversi passaggi. In questo esempio, si inizia recuperando l'oggetto di configurazione vocale chiamando Get-CsVoiceConfiguration. L'oggetto recuperato (sarà solo uno) viene assegnato alla variabile $a.

Nella riga 2 di questo esempio viene recuperato dalla variabile $a il contenuto della proprietà VoiceTestConfigurations, che è una raccolta di oggetti di configurazione di test vocale. La raccolta viene quindi inviata tramite pipe al cmdlet Where-Object, che cerca nella raccolta stessa l'oggetto di configurazione di test vocale con nome uguale alla stringa TestConfig2. Tale oggetto viene assegnato alla variabile $b.

Successivamente, l'oggetto di configurazione di test vocale TestConfig2 viene modificato assegnando nuovi valori alle proprietà DialedNumber e ExpectedTranslatedNumber. Aggiornando l'oggetto viene aggiornato anche l'oggetto nella variabile $a, che tuttavia rimane ancora solo in memoria. Per ultimo, è necessario salvare le modifiche passando $a al parametro Instance di Set-CsVoiceConfiguration.

Non è il modo consigliato per modificare una configurazione vocale. Per modificare una configurazione vocale, modificare semplicemente le singole configurazioni di test vocale con la proprietà Set-CsVoiceTestConfiguration, come mostrato di seguito:

Set-CsVoiceTestConfiguration -Identity TestConfig2 -DialedNumber 5551212 -ExpectedTranslatedNumber +5551212

Questa unica riga permette di eseguire le stesse operazioni mostrate nell'esempio 1.