Condividi tramite

  • Articolo

New-CsVoicePolicy

 

Ultima modifica dell'argomento: 2012-03-25

Crea un nuovo criterio vocale.

Sintassi

New-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>] [-InMemory <SwitchParameter>] [-Name <String>] [-PreventPSTNTollBypass <$true | $false>] [-PstnUsages <PSListModifier>] [-WhatIf [<SwitchParameter>]]

Descrizione dettagliata

Questo cmdlet consente di creare un nuovo criterio vocale. 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. Il criterio creato da questo cmdlet determina se molte di queste funzionalità sono abilitate o disabilitate.

Utenti che possono eseguire questo cmdlet: per impostazione predefinita, i membri dei gruppi riportati di seguito sono autorizzati ad eseguire il cmdlet New-CsVoicePolicy in locale: RTCUniversalServerAdmins. Per restituire un elenco di tutti i ruoli RBAC (Role-Based Access Control, controllo dell'accesso basato sui ruoli) a cui è stato assegnato questo cmdlet (compresi eventuali ruoli RBAC personalizzati creati autonomamente), eseguire il cmdlet riportato di seguito dal prompt di Windows PowerShell:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsVoicePolicy"}

Parametri

Parameter Obbligatorio Tipo Descrizione

Identity

Obbligatorio

Identità XDS

Un identificatore univoco che specifica l'ambito o il nome del criterio. I valori validi per questo cmdlet sono site:<nome sito>, dove <nome sito> corrisponde al nome del sito Microsoft Lync Server 2010 a cui applicare le impostazioni, ad esempio site:Redmond, e una stringa che designa un criterio per utente, ad esempio RedmondVoicePolicy. Un criterio globale è presente per impostazione predefinita.

AllowCallForwarding

Facoltativo

Booleano

Se questo parametro è impostato su True, le chiamate possono essere inoltrate. Se questo parametro è impostato su False, le chiamate non possono essere inoltrate.

Valore predefinito: True

AllowPSTNReRouting

Facoltativo

Booleano

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

Valore predefinito: True

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 abilitata questa funzionalità. Se questo parametro è impostato su False, lo squillo simultaneo non può essere configurato per alcun utente a cui è assegnato questo criterio.

Valore predefinito: True

Description

Facoltativo

Stringa

Una descrizione del criterio vocale.

Lunghezza massima: 1040 caratteri.

EnableBWPolicyOverride

Facoltativo

Booleano

I criteri possono essere impostati per gestire la configurazione della rete, compresa la limitazione della larghezza di banda. 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.

Valore predefinito: False

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 del parametro su True viene abilitata l'applicazione. Se il parametro è impostato su False, gli utenti a cui è assegnato questo criterio non possono parcheggiare le chiamate effettuate verso il loro numero telefonico.

Valore predefinito: False

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.

Valore predefinito: True

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.

Valore predefinito: True

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 solo per le autorità preposte, non per l'utente. Se questa proprietà è impostata su True, sarà possibile registrare le chiamate dannose.

Valore predefinito: False

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à.

Valore predefinito: True

Name

Facoltativo

Stringa

Nome visualizzabile per questo criterio.

Valore predefinito: DefaultPolicy

PreventPSTNTollBypass

Facoltativo

Booleano

I numeri a tariffa PSTN sono più comunemente noti come numeri a tariffa interurbana. Le organizzazioni possono talvolta aggirare l'utilizzo di 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 saranno inviate tramite PSTN e sarà necessario sostenere i costi relativi, che potrebbero essere eliminati utilizzando la rete per evitare i numeri a tariffa.

Valore predefinito: False

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.

Per impostazione predefinita, questo elenco è vuoto. Se non viene fornito un valore per questo parametro, viene visualizzato un messaggio di avviso che indica che gli utenti a cui viene assegnato questo criterio non potranno effettuare chiamate PSTN esterne.

Force

Facoltativo

Parametro opzionale

Elimina qualsiasi richiesta di conferma che, in caso contrario, sarebbe visualizzata prima di effettuare le modifiche.

InMemory

Facoltativo

Parametro opzionale

Crea un riferimento a un oggetto senza eseguire realmente il commit dell'oggetto come modifica permanente. Se si assegna l'output del cmdlet chiamato con questo parametro a una variabile, è possibile apportare modifiche alle proprietà del riferimento all'oggetto e quindi eseguire il commit di queste modifiche chiamando il cmdlet Set- corrispondente.

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

Nessuno.

Tipi restituiti

Questo cmdlet consente di creare un'istanza dell'oggetto Microsoft.Rtc.Management.WritableConfig.Voice.VoicePolicy.

Esempio

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

New-CsVoicePolicy -Identity UserVoicePolicy1

Con questo esempio viene creato un nuovo criterio vocale per utente con le impostazioni predefinite, la cui identità è UserVoicePolicy1.

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

New-CsVoicePolicy UserVoicePolicy2 -AllowSimulRing $false -PstnUsages @{add = "Local"}

Con questo esempio viene creato un nuovo criterio vocale per utente con identità UserVoicePolicy2; la proprietà AllowSimulRing viene impostata su False, 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, inoltre, consente di aggiungere "Local" all'elenco degli utilizzi PSTN per associare questo criterio vocale a una route vocale che impiega l'utilizzo PSTN Local. 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 3 --------------------------

$a = Get-CsPstnUsage
New-CsVoicePolicy site:Redmond -PstnUsages @{add = $a.Usage}

Con questo esempio viene creato un nuovo criterio vocale per il sito Redmond e al criterio vengono applicati tutti gli utilizzi PSTN definiti per l'organizzazione. La prima riga nell'esempio chiama il cmdlet Get-CsPstnUsage per recuperare il set globale di utilizzi PSTN per l'organizzazione e salvarlo nella variabile $a. Nella seconda riga viene chiamato New-CsVoicePolicy per creare il nuovo criterio vocale per il sito Redmond. Al parametro PstnUsages viene passato un valore per aggiungere al criterio l'elenco contenuto nel set globale di utilizzi PSTN. Si noti la sintassi del valore aggiunto, $a.Usage. Fa riferimento alla proprietà Usage delle impostazioni di utilizzo PSTN, che contiene l'elenco di utilizzi PSTN.