Condividi tramite

  • Articolo

Set-CsVoicePolicy

 

Ultima modifica dell'argomento: 2012-03-27

Modifica un criterio vocale esistente.

Sintassi

Set-CsVoicePolicy [-Identity <XdsIdentity>] [-AllowCallForwarding <$true | $false>] [-AllowPSTNReRouting <$true | $false>] [-AllowSimulRing <$true | $false>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-EnableBWPolicyOverride <$true | $false>] [-EnableCallPark <$true | $false>] [-EnableCallTransfer <$true | $false>] [-EnableDelegation <$true | $false>] [-EnableMaliciousCallTracing <$true | $false>] [-EnableTeamCall <$true | $false>] [-Force <SwitchParameter>] [-Name <String>] [-PreventPSTNTollBypass <$true | $false>] [-PstnUsages <PSListModifier>] [-WhatIf [<SwitchParameter>]]

Set-CsVoicePolicy [-AllowCallForwarding <$true | $false>] [-AllowPSTNReRouting <$true | $false>] [-AllowSimulRing <$true | $false>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-EnableBWPolicyOverride <$true | $false>] [-EnableCallPark <$true | $false>] [-EnableCallTransfer <$true | $false>] [-EnableDelegation <$true | $false>] [-EnableMaliciousCallTracing <$true | $false>] [-EnableTeamCall <$true | $false>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-Name <String>] [-PreventPSTNTollBypass <$true | $false>] [-PstnUsages <PSListModifier>] [-WhatIf [<SwitchParameter>]]

Descrizione dettagliata

Questo cmdlet consente di modificare un criterio vocale esistente. I criteri vocali sono utilizzati per gestire funzionalità di VoIP aziendale quali, ad esempio, lo squillo simultaneo (vale a dire la capacità di far squillare un secondo telefono ogni volta che si riceve una chiamata sul telefono dell'ufficio) e l'inoltro di chiamata. Utilizzare questo cmdlet per modificare le impostazioni che abilitano o disabilitano molte di queste funzionalità.

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

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Facoltativo

Stringa

Un identificatore univoco che specifica l'ambito, e in alcuni casi il nome, del criterio.

Instance

Facoltativo

VoicePolicy

Consente di passare al cmdlet un riferimento a un oggetto anziché impostare singoli valori di parametro. Questo oggetto deve essere di tipo VoicePolicy e può essere recuperato chiamando il cmdlet Get-CsVoicePolicy.

AllowCallForwarding

Facoltativo

Booleano

Se questo parametro è impostato su True, gli utenti a cui è assegnato il criterio potranno inoltrare le chiamate. Se questo parametro è impostato su False, le chiamate non possono essere inoltrate.

AllowPSTNReRouting

Facoltativo

Booleano

Se questo parametro è impostato su True, le chiamate effettuate ai numeri interni residenti in un altro pool verranno instradate attraverso la rete PSTN (Public Switched Telephone Network) nel caso in cui il pool o la rete WAN non sia disponibile.

AllowSimulRing

Facoltativo

Booleano

Lo squillo simultaneo è una funzionalità che consente di far squillare più telefoni quando viene composto un singolo numero. Con l'impostazione del parametro su True viene abilitato lo squillo simultaneo. Se questo parametro è impostato su False, lo squillo simultaneo non può essere configurato per alcun utente assegnato a questo criterio.

Description

Facoltativo

Stringa

Una descrizione del criterio vocale.

Lunghezza massima: 1040 caratteri.

EnableBWPolicyOverride

Facoltativo

Booleano

È possibile impostare i criteri in modo che limitino la larghezza di banda e definiscano altre proprietà relative alla configurazione di rete. Se il parametro viene impostato su True è possibile sostituire questi criteri. In altri termini, se il parametro è impostato su True, non verranno eseguite verifiche sulla larghezza di banda e le chiamate verranno passate indipendentemente dalle impostazioni del servizio Controllo di ammissione di chiamata.

EnableCallPark

Facoltativo

Booleano

applicazione Parcheggio di chiamata consente di mettere in attesa, o parcheggiare, una chiamata effettuata a un determinato numero all'interno di un gruppi di numeri, in modo da riprenderla successivamente. Con l'impostazione di questo parametro su True l'applicazione viene abilitata per gli utenti a cui è assegnato questo criterio. Se il parametro è impostato su False, gli utenti a cui è assegnato questo criterio non possono parcheggiare le chiamate effettuate verso il loro numero telefonico.

EnableCallTransfer

Facoltativo

Booleano

Determina se è possibile trasferire le chiamate a un altro numero. Se questo parametro è impostato su True, le chiamate possono essere trasferite; se il parametro è impostato su False, le chiamate non possono essere trasferite.

EnableDelegation

Facoltativo

Booleano

La delega delle chiamate consente a un utente di rispondere alle chiamate di un altro utente oppure di effettuare chiamate per conto dell'altro utente. Ad esempio, un manager può impostare la delega delle chiamate in modo che tutte le chiamate in arrivo squillino sia sul suo telefono sia su quello di un amministratore. Se il parametro viene impostato su True, gli utenti con questo criterio possono configurare la delega delle chiamate. Con l'impostazione del parametro su False viene disabilitata la delega delle chiamate.

EnableMaliciousCallTracing

Facoltativo

Booleano

La registrazione delle chiamate dannose è uno standard che consente di registrare le chiamate che un utente ha designato come dannose. Queste chiamate possono essere registrate anche se l'ID del chiamante è bloccato. La registrazione è disponibile solamente per le autorità, non per l'utente. Se questa proprietà è impostata su True, sarà possibile registrare le chiamate dannose.

EnableTeamCall

Facoltativo

Booleano

Intercettazione team consente a un utente di designare un gruppo di altri utenti i cui telefoni squilleranno quando viene chiamato il numero di tale utente. Questa funzionalità è utile nei gruppi in cui, ad esempio, qualunque membro può rispondere alle chiamate in entrata provenienti dai clienti. Con l'impostazione del parametro su True viene abilitata questa funzionalità.

Name

Facoltativo

Stringa

Un nome descrittivo per questo criterio.

PreventPSTNTollBypass

Facoltativo

Booleano

I numeri a tariffa PSTN sono più comunemente noti come numeri a tariffa interurbana. Le organizzazioni possono a volte bypassare questi numeri a tariffa implementando una soluzione VoIP (Voice over Internet Protocol) che permetta di connettere le succursali attraverso chiamate di rete. Se il parametro è impostato su True, le chiamate verranno inviate attraverso la rete PSTN e sarà necessario sostenere costi che potrebbero essere eliminati sfruttando la rete ed evitando i numeri a tariffa.

PstnUsages

Facoltativo

PSListModifier

Un elenco di utilizzi PSTN disponibili per questo criterio. L'utilizzo PSTN collega un criterio vocale a una route telefonica.

Qualsiasi valore stringa può essere collocato nell'elenco purché esistente nell'elenco globale corrente di utilizzi PSTN. Le stringhe duplicate non sono ammesse; tutte le stringhe devono essere univoche. Per recuperare gli utilizzi PSTN, è possibile richiamare il cmdlet Get-CsPstnUsage.

Ricordare che se si utilizza questo parametro per rimuovere tutti gli utilizzi PSTN dal criterio, gli utenti assegnati al criterio non saranno in grado di effettuare chiamate PSTN in uscita.

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.VoicePolicy. Accetta l'input da pipeline di oggetti criterio vocale.

Tipi restituiti

Questo cmdlet non restituisce un valore o un oggetto. Configura piuttosto le istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Voice.VoicePolicy.

Esempio

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

Set-CsVoicePolicy UserVoicePolicy2 -AllowSimulRing $false -PstnUsages @{remove="Local"}

Con questo esempio viene impostata la proprietà AllowSimulRing su False per il criterio per utente UserVoicePolicy2 in modo che qualsiasi utente a cui è assegnato questo criterio non sia abilitato per lo squillo simultaneo, una funzionalità che determina se è possibile impostare un secondo telefono (ad esempio un cellulare) affinché squilli ogni volta che squilla il telefono dell'ufficio dell'utente. Questo comando rimuove anche "Local" dall'elenco degli utilizzi PSTN per questo criterio. Il parametro Identity non è specificato in modo esplicito. Il parametro Identity è un parametro posizionale, pertanto se si inserisce il valore dell'identità al primo posto nell'elenco dei parametri non è necessario dichiarare esplicitamente che si tratta di Identity.

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

$a = Get-CsPstnUsage
Set-CsVoicePolicy -Identity site:Redmond -PstnUsages @{replace=$a.Usage}

Con questo esempio viene modificato il criterio vocale per il sito Redmond per cui tutti gli utilizzi PSTN definiti per l'organizzazione sono applicati a questo criterio. Con la prima riga dell'esempio viene richiamato il cmdlet Get-CsPstnUsage per recuperare il set globale degli utilizzi PSTN per l'organizzazione e salvato questo set nella variabile $a. Con la seconda riga viene richiamato Set-CsVoicePolicy per modificare il criterio vocale per il sito Redmond. Al parametro PstnUsages viene passato un valore per sostituire l'elenco corrente di utilizzi per il criterio con l'elenco contenuto nel set globale di utilizzi PSTN. Si noti la sintassi del valore replace, $a.Usage. Fa riferimento alla proprietà Usage delle impostazioni di utilizzo PSTN, che contiene l'elenco di utilizzi PSTN.