Condividi tramite

  • Articolo

Get-CsDialInConferencingDtmfConfiguration

 

Ultima modifica dell'argomento: 2012-03-23

Consente di restituire le impostazioni del segnale DTMF (Dual Tone Multi-Frequency) per le conferenze telefoniche con accesso esterno. La tecnologia DTMF consente agli utenti che accedono dall'esterno a una conferenza di controllare le impostazioni della conferenza, ad esempio disattivare e riattivare il proprio audio o bloccare e sbloccare la conferenza, mediante la tastiera del telefono.

Sintassi

Get-CsDialInConferencingDtmfConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]

Get-CsDialInConferencingDtmfConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>]

Descrizione dettagliata

Microsoft Lync Server 2010 consente agli utenti di partecipare alle conferenze accedendo dall'esterno tramite il telefono. Gli utenti esterni non possono visualizzare video né scambiare messaggi istantanei con gli altri partecipanti della conferenza, ma possono partecipare completamente alla parte audio della riunione.

Oltre alla possibilità di partecipare a una conferenza, gli utenti possono inoltre gestire parti selezionate della conferenza mediante la tastiera del telefono. La gestione delle specifiche impostazioni della conferenza varia a seconda che l'utente sia o meno un relatore. Ad esempio, per impostazione predefinita, gli utenti possono premere il tasto 6 della tastiera per disattivare o riattivare il proprio audio. I partecipanti possono riprodurre in privato i nomi di tutti gli altri partecipanti alla riunione, mentre i relatori, ad esempio, possono disattivare e riattivare l'audio di tutti i partecipanti alla riunione e abilitare o disabilitare l'annuncio riprodotto ogni volta che qualcuno accede a una conferenza o abbandona la conferenza.

La possibilità di effettuare selezioni mediante la tastiera del telefono è nota come segnalazione DTMF: quando si compone un numero di telefono e la voce registrata chiede di "premere 1 per l'inglese o 2 per l'italiano", questo è un esempio di segnalazione DTMF. Il cmdlet Get-CsDialInConferencingDtmfConfiguration consente di recuperare un elenco di tutti i comandi DTMF disponibili, nonché i tasti utilizzati per eseguire tali comandi.

Utenti che possono eseguire questo cmdlet: per impostazione predefinita, i membri dei gruppi riportati di seguito sono autorizzati ad eseguire il cmdlet Get-CsDialInConferencingDtmfConfiguration in locale: RTCUniversalUserAdmins, 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 "Get-CsDialInConferencingDtmfConfiguration"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Facoltativo

Stringa

Indica l'identificatore univoco per l'insieme di impostazioni DTMF da restituire. Per fare riferimento alle impostazioni globali, utilizzare la sintassi seguente: -Identity global. Per far riferimento a una raccolta configurata nell'ambito del sito, utilizzare una sintassi simile alla seguente: -Identity site:Redmond. Si noti che non è possibile utilizzare i caratteri jolly quando si specifica un parametro Identity. Tuttavia, se è necessario utilizzare caratteri jolly, utilizzare il parametro Filter.

Se questo parametro non viene specificato, Get-CsDialInConferencingDtmfConfiguration restituisce una raccolta di tutte le impostazioni di configurazione DTMF in uso nell'organizzazione.

Filter

Facoltativo

Stringa

Consente di utilizzare caratteri jolly al fine di restituire una raccolta, o più raccolte, delle impostazioni di configurazione DTMF. Per restituire una raccolta di tutte le impostazioni configurate nell'ambito del sito, utilizzare la sintassi seguente: -Filter site:*. Per restituire una raccolta di tutte le impostazioni che contengono il valore stringa "EMEA" in Identity (l'unica proprietà su cui è possibile applicare il filtro), utilizzare la sintassi riportata di seguito: -Filter *EMEA*.

LocalStore

Facoltativo

Parametro opzionale

Consente di recuperare i dati di configurazione DTMF dalla replica locale dell'archivio di gestione centrale anziché dall'archivio di gestione centrale stesso.

Tipi di input

Nessuno. Get-CsDialInConferencingDtmfConfiguration non accetta l'input da pipeline.

Tipi restituiti

Get-CsDialInConferencingDtmfConfiguration restituisce le istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Settings.DialInConferencingSettings.DialInConferencingDtmfConfiguration.

Esempio

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

Get-CsDialInConferencingDtmfConfiguration -Identity site:Redmond

Il comando mostrato nell'esempio 1 restituisce le impostazioni DTMF per il sito Redmond.

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

Get-CsDialInConferencingDtmfConfiguration | Select-Object Identity, HelpCommand

Nell'esempio 2 viene restituita una raccolta di tutte le impostazioni DTMF, quindi per ogni elemento nella raccolta viene visualizzato il valore del tasto da premere al fine di riprodurre in privato una descrizione dei comandi DTMF. A tale scopo, viene chiamato il cmdlet Get-CsDialInConferencingDtmfConfiguration affinché restituisca una raccolta di tutti i valori delle proprietà di tutte le impostazioni DTMF attualmente in uso nell'organizzazione. La raccolta viene quindi inviata tramite pipe al cmdlet Select-Object, che seleziona due proprietà (Identity ed HelpCommand) da visualizzare sullo schermo.

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

Get-CsDialInConferencingDtmfConfiguration -Filter "site:*"

Il comando mostrato nell'esempio 3 restituisce tutte le impostazioni DTMF configurate nell'ambito del sito. Questa operazione viene eseguita includendo il parametro Filter e il valore del filtro "site:*". Questo valore filtro limita i dati restituiti alle impostazioni la cui identità inizia con i caratteri "site:". Per definizione, tali impostazioni sono configurate nell'ambito del sito.

-------------------------- Esempio 4 ------------------------

Get-CsDialInConferencingDtmfConfiguration | Where-Object {$_.AdmitAll -ne 8}

Il comando precedente restituisce tutte le impostazioni di configurazione DTMF in cui la proprietà AdmitAll è diversa da 8 (valore predefinito). Per eseguire questa operazione, viene innanzitutto chiamato Get-CsDialInConferencingDtmfConfiguration senza l'inclusione di parametri, al fine di restituire una raccolta di tutte le impostazioni DTMF attualmente in uso. La raccolta così ottenuta viene quindi inviata tramite pipe al cmdlet Where-Object, che seleziona solo quelle impostazioni in cui la proprietà AdmitAll non è uguale a 8.