Condividi tramite

  • Articolo

Set-CsDialInConferencingDtmfConfiguration

 

Ultima modifica dell'argomento: 2012-03-27

Modifica le impostazioni della segnalazione multifrequenza a doppio tono (DTMF, Dual-Tone Multi-Frequency) utilizzate 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

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

Set-CsDialInConferencingDtmfConfiguration [-AdmitAll <String>] [-AudienceMuteCommand <String>] [-CommandCharacter <String>] [-Confirm [<SwitchParameter>]] [-EnableDisableAnnouncementsCommand <String>] [-Force <SwitchParameter>] [-HelpCommand <String>] [-Instance <PSObject>] [-LockUnlockConferenceCommand <String>] [-MuteUnmuteCommand <String>] [-PrivateRollCallCommand <String>] [-WhatIf [<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 possono ad esempio 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 la abbandona.

La possibilità di effettuare tali selezioni mediante la tastiera del telefono è nota come segnalazione DTMF (Dual-Tone Multifrequency, multifrequenza a doppio tono). Quando si compone un numero di telefono e una voce registrata indica ad esempio di "premere 1 per l'inglese o 2 per l'italiano", si sta utilizzando la segnalazione DTMF.

Il cmdlet Set-CsDialInConferencingDtmfConfiguration consente di cambiare i tasti utilizzati per attivare i comandi supportati in una conferenza telefonica con accesso esterno di Lync Server 2010.

Quando si modificano i comandi DTMF, tenere presenti due aspetti. In primo luogo, è possibile utilizzare solo i tasti numerici da 0 a 9. Tutti gli altri tasti che potrebbero essere presenti sulla tastiera, ad esempio il tasto #, non sono consentiti. Esiste un'eccezione a questa regola: il parametro CommandCharacter consente di utilizzare solo il tasto asterisco (*) o il tasto cancelletto (#). Non è possibile assegnare un valore numerico al parametro CommandCharacter. Tutti gli altri parametri dei comandi accetteranno invece solo valori numerici.

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 a EnableDisableAnnouncementsCommand, il cui valore predefinito è 9, sarà necessario contestualmente assegnare il tasto 9 ad AudienceMuteCommand.

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

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

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Facoltativo

Stringa

Indica l'identificatore univoco per la raccolta di impostazioni DTMF da modificare. Per fare riferimento alle impostazioni globali, utilizzare la seguente sintassi: -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.

Se questo parametro non viene specificato, Set-CsDialInConferencingDtmfConfiguration modificherà le impostazioni DTMF globali.

Instance

Facoltativo

Oggetto DialInConferencingDtmfConfiguration

Consente di passare al cmdlet un riferimento a un oggetto anziché impostare singoli valori di parametro.

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 può essere premuto da un relatore per disattivare l'audio di tutti i partecipanti alla conferenza, ovvero verrà disattivato l'audio di tutti i partecipanti tranne quello del relatore. Il tasto predefinito è 4.

CommandCharacter

Facoltativo

Stringa

Indica il tasto da premere all'inizio di un comando. Il tasto predefinito è l'asterisco (*). L'unico altro valore consentito è il tasto cancelletto (#).

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. Viene utilizzato lo stesso tasto per passare dalla disattivazione all'attivazione 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

Parametro opzionale

Consente di non visualizzare i messaggi relativi agli errori non irreversibili che possono verificarsi durante l'esecuzione del comando.

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.Settings.DialInConferencingSettings.DialInConferencingDtmfConfiguration. Set-CsDialInConferencingDtmfConfiguration accetta le istanze da pipeline dell'oggetto configurazione DTMF di conferenza telefonica con accesso esterno.

Tipi restituiti

Set-CsDialInConferencingDtmfConfiguration non restituisce un oggetto o un valore. Il cmdlet piuttosto configura le istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Settings.DialInConferencingSettings.DialInConferencingDtmfConfiguration.

Esempio

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

Set-CsDialInConferencingDtmfConfiguration -Identity global -EnableDisableAnnouncementsCommand 4 -AudienceMuteCommand 9

Il comando riportato nell'esempio 1 sostituisce il tasto assegnato al comando per l'abilitazione e la disabilitazione degli annunci, il cui valore predefinito è 9, con il tasto assegnato al comando per la disattivazione e l'attivazione dell'audio di tutti i partecipanti, il cui valore predefinito è 4, per le impostazioni DTMF globali. A tale scopo, vengono utilizzati due parametri diversi: EnableDisableAnnoucementsCommand, a cui viene assegnato il valore 4, e AudienceMuteCommand, a cui viene assegnato il valore 9. Poiché non è specificato il parametro Identity, queste modifiche avranno effetto sulle impostazioni DTMF globali.

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

Set-CsDialInConferencingDtmfConfiguration -Identity site:Redmond -EnableDisableAnnouncementsCommand 4 -AudienceMuteCommand 9

Il comando mostrato nell'esempio 2 rappresenta una variazione del comando mostrato nel primo esempio. In questo caso, le modifiche avranno effetto sulle impostazioni DTMF che hanno il valore Identity site:Redmond.

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

Set-CsDialInConferencingDtmfConfiguration -Identity "site:Redmond" -PrivateRollCallCommand $Null

Il comando riportato nell'esempio 3 disabilita per il sito Redmond il comando per l'appello, ovvero la capacità di riprodurre un elenco di tutti i partecipanti alla conferenza. Per disabilitare questo comando, viene incluso il parametro PrivateRollCallCommand con valore $Null. Ciò significa che al comando non verrà associato alcun tasto, rendendolo così non disponibile per gli utenti.

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

Get-CsDialInConferencingDtmfConfiguration -Filter "site:*" | Set-CsDialInConferencingDtmfConfiguration -PrivateRollCallCommand $Null

L'esempio 4 rappresenta una variazione dell'esempio 3. In questo esempio il comando per l'appello viene disabilitato per tutte le impostazioni DTMF configurate nell'ambito del sito. A tale scopo, nel comando vengono innanzitutto utilizzati Get-CsDialInConferencingDtmfConfiguration e il parametro Filter per restituire una raccolta di tutte le impostazioni configurate nell'ambito del sito. Il valore di filtro "site:*" circoscrive i dati restituiti alle impostazioni con valore Identity che inizia con i caratteri "site:". La raccolta filtrata viene quindi inviata tramite pipe a Set-CsDialInConferencingDtmfConfiguration, che imposta il valore della proprietà PrivateRollCallCommand su Null ($Null).