Condividi tramite

  • Articolo

New-CsDialInConferencingDtmfConfiguration

 

Ultima modifica dell'argomento: 2012-03-23

Crea una nuova raccolta di impostazioni di segnalazione DTMF (Dual Tone Multi-Frequency) utilizzate per le conferenze telefoniche con accesso esterno. DTMF consente agli utenti che accedono a una conferenza di controllarne le impostazioni (ad esempio, disattivando o riattivando il loro microfono oppure bloccando o sbloccando la conferenza) tramite la tastiera del telefono.

Sintassi

New-CsDialInConferencingDtmfConfiguration -Identity <XdsIdentity> [-AdmitAll <String>] [-AudienceMuteCommand <String>] [-CommandCharacter <String>] [-Confirm [<SwitchParameter>]] [-EnableDisableAnnouncementsCommand <String>] [-Force <SwitchParameter>] [-HelpCommand <String>] [-InMemory <SwitchParameter>] [-LockUnlockConferenceCommand <String>] [-MuteUnmuteCommand <String>] [-PrivateRollCallCommand <String>] [-WhatIf [<SwitchParameter>]]

Descrizione dettagliata

Microsoft Lync Server 2010 consente agli utenti di partecipare alle conferenze accedendovi tramite telefono. Questi utenti non sono in grado di visualizzare video o scambiare messaggi istantanei con altri partecipanti, ma possono accedere alla parte audio della riunione.

Oltre a poter partecipare alla conferenza, gli utenti saranno in grado di gestire determinate parti della conferenza utilizzando la tastiera del telefono. Le specifiche impostazioni che gli utenti possono gestire dipendono dal fatto di essere o meno il relatore. Ad esempio, per impostazione predefinita, premendo il tasto 6 gli utenti possono disattivare o riattivare il loro microfono. I partecipanti possono riprodurre i nomi di tutti gli altri partecipanti, mentre i relatori possono eseguire anche altre operazioni come, ad esempio, disattivare e riattivare il microfono di tutti i partecipanti oppure abilitare/disabilitare l'annuncio riprodotto ogni volta che un utente accede o lascia la conferenza.

La possibilità di eseguire queste operazioni tramite la tastiera del telefono è definita "segnale DTMF (Dual Tone Multi-Frequency)": chiunque abbia mai digitato un numero telefonico e ascoltato messaggi tipo "Premere 1 per attivare questa opzione o premere 2 per parlare con un operatore" ha utilizzato un segnale DTMF.

Quando si installa Lync Server 2010, viene automaticamente creata una raccolta globale di impostazioni DTMF. Oltre a queste impostazioni globali, è possibile utilizzare il cmdlet New-CSDialInConferencingDtmfConfiguration per creare impostazioni personalizzate sito per sito. Ad esempio, è possibile creare una nuova raccolta di impostazioni per il sito Redmond (e solo per il sito Redmond) che utilizzi il tasto 4 anziché il tasto 6 per attivare o disattivare l'audio del microfono. Notare che qualsiasi impostazione che si configura con ambito di sito ha la priorità sulle impostazioni configurate con ambito globale. Come risultato, gli utenti del sito Redmond utilizzeranno il tasto 4 per attivare o disattivare l'audio del microfono anche se le impostazioni globali prevedono l'utilizzo del tasto 6 per tale scopo.

È possibile disporre di una sola raccolta di impostazioni DTMF e di una raccolta globale per sito. Si supponga, ad esempio, di disporre già di una raccolta con identità site:Redmond e di tentare di eseguire il comando seguente:

New- CSDialInConferencingDtmfConfiguration –Identity site:Redmond

Questo comando non riuscirà poiché la raccolta site:Redmond esiste già. Se si desidera modificare le impostazioni del sito Redmond, utilizzare il cmdlet Set-CSDialInConferencingDtmfConfiguration o rimuovere la raccolta esistente e quindi creare una nuova raccolta che utilizza l'identità site:Redmond.

Quando si configurano valori per i comandi DTMF, tenere presenti due aspetti. Innanzitutto, è esclusivamente possibile utilizzare i tasti numerici da 0 a 9 e l'asterisco (*); non consentito alcun altro tasto presente sul tastierino (quale il tasto #). Con una eccezione: il parametro CommandCharacter accetta solo il tasto asterisco (*) o cancelletto (#). In secondo luogo, ai comandi devono essere assegnati tasti univoci. Il tasto 4, ad esempio, non può essere utilizzato sia per disattivare e riattivare il proprio audio che per bloccare e sbloccare una conferenza. Ciò significa che, quando si modificano i tasti assegnati a un comando, potrebbe essere necessario sostituire i tasti utilizzati da due comandi diversi. Se ad esempio si desidera assegnare il tasto 4 al comando EnableDisableAnnouncementsCommand, il cui valore predefinito è 9, sarà necessario contestualmente assegnare il tasto 9 al comando AudienceMuteCommand.

Per disabilitare un comando, impostarne il valore su Null ($Null).

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

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Obbligatorio

XdsIdentity

Identificatore univoco da assegnare alla nuova raccolta di impostazioni di configurazione DTMF. Poiché è possibile creare nuove raccolte solo nell'ambito del sito, l'identità avrà sempre il prefisso "site:" seguito dal nome del sito; ad esempio "site:Redmond".

AdmitAll

Facoltativo

Stringa

Indica il tasto da premere per consentire a tutti gli utenti che si trovano in sala di attesa di accedere immediatamente alla conferenza. Il valore predefinito è 8.

AudienceMuteCommand

Facoltativo

Stringa

Indica il tasto che un relatore può premere per attivare o disattivare l'audio di tutti gli altri partecipanti alla conferenza (verrà attivato o disattivato l'audio di tutti i partecipanti tranne il relatore). Il tasto predefinito è 4.

CommandCharacter

Facoltativo

Stringa

Indica il tasto da premere all'inizio di un comando. Il tasto predefinito è asterisco (*). Il solo valore consentito è #.

EnableDisableAnnouncementsCommand

Facoltativo

Stringa

Indica il tasto da premere per abilitare o disabilitare gli annunci ogni volta che qualcuno accede a una conferenza o abbandona la conferenza. Il tasto predefinito è 9.

HelpCommand

Facoltativo

Stringa

Indica il tasto da premere per riprodurre in privato una descrizione di tutti i comandi DTMF. Il tasto predefinito è 1.

LockUnlockConferenceCommand

Facoltativo

Stringa

Indica il tasto da premere per bloccare o sbloccare una conferenza. Se una conferenza è bloccata, non sarà consentito l'accesso a nuovi partecipanti, almeno finché la conferenza non viene sbloccata. Il tasto predefinito è 7.

MuteUnmuteCommand

Facoltativo

Stringa

Indica il tasto da premere per disattivare o riattivare il proprio audio (utilizzare lo stesso tasto per passare dalla disattivazione alla riattivazione audio e viceversa). Il tasto predefinito è 6.

PrivateRollCallCommand

Facoltativo

Stringa

Indica il tasto da premere per riprodurre in privato il nome di ogni partecipante alla conferenza. Il tasto predefinito è 3.

Force

Facoltativo

Parametro opzionale

Consente di evitare la visualizzazione di qualunque messaggio di errore non grave che potrebbe essere generato nel corso dell'esecuzione del comando.

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. New-CsDialInConferencingDtmfConfiguration non accetta input tramite pipeline.

Tipi restituiti

Consente di creare nuove istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Settings.DialInConferencingSettings.DialInConferencingDtmfConfiguration.

Esempio

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

New-CSDialInConferencingDtmfConfiguration -Identity site:Redmond -MuteUnmuteCommand 4 -AudienceMuteCommand 6

Nell'esempio 1 viene creato un nuovo set di impostazioni di configurazione DTMF per il sito Redmond. In questo esempio, la proprietà MuteUnmuteCommand è impostata su 4 e la proprietà AudienceMuteCommand è impostata su 6.

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

New-CSDialInConferencingDtmfConfiguration -Identity site:Redmond -AdmitAll $Null

Il comando precedente crea un nuovo set di impostazioni di configurazione DTMF per il sito Redmond. In questo esempio, viene disabilitata la proprietà AdmitAll utilizzando il parametro AdmitAll e impostando il valore del parametro su null.

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

$x = New-CSDialInConferencingDtmfConfiguration -Identity site:Redmond -InMemory
$x.AdmitAll = $Null
$x.MuteUnmuteCommand = 4 
$x.AudienceMuteCommand = 6
Set-CSDialInConferencingDtmfConfiguration -Instance $x

Nell'esempio 3 viene illustrato come è possibile utilizzare il parametro InMemory per creare un'istanza solo in memoria di una raccolta di impostazioni di configurazione DTMF, modificare tali impostazioni e quindi utilizzare Set-CSDialInConferencingDtmfConfiguration per creare una raccolta effettiva con l'identità site:Redmond. A tal fine, il primo comando nell'esempio crea una nuova istanza solo in memoria di una raccolta di impostazioni di configurazione DTMF e archivia tale istanza in una variabile denominata $x. Queste impostazioni saranno presenti solo in memoria. Se si chiude Windows PowerShell o se si elimina la variabile $x, le impostazioni scompariranno e non verranno mai applicate al sito Redmond.

I 3 comandi seguenti modificano le proprietà di questa raccolta di impostazioni DTMF virtuale: i comandi 2, 3 e 4 assegnano nuovi valori rispettivamente a AdmitAll, MuteUnmuteCommand e AudienceMuteCommand. Il comando finale utilizza quindi Set-CSDialInConferencingDtmfConfiguration e il parametro $x per trasformare la raccolta virtuale in una raccolta effettiva di impostazioni configurate per il sito Redmond.