Set-CsAudioTestServiceApplication
Ultima modifica dell'argomento: 2012-03-27
Consente di modificare i valori di proprietà per i contatti dell'applicazione di servizio di test audio attualmente in uso nell'organizzazione.
Sintassi
Set-CsAudioTestServiceApplication -Identity <UserIdParameter> [-Confirm [<SwitchParameter>]] [-CSEnabled <$true | $false>] [-DisplayName <String>] [-DisplayNumber <String>] [-EnabledForFederation <$true | $false>] [-EnterpriseVoiceEnabled <$true | $false>] [-LineURI <String>] [-PassThru <SwitchParameter>] [-PrimaryLanguage <String>] [-SecondaryLanguages <MultiValuedProperty>] [-SipAddress <String>] [-Type <String>] [-WhatIf [<SwitchParameter>]]
Descrizione dettagliata
Il servizio di test audio consente agli utenti di Microsoft Lync 2010 di testare le connessioni vocali prima di effettuare una chiamata vocale. A tale scopo, gli utenti fanno clic sul pulsante Controlla qualità chiamata che si trova nella scheda Dispositivo audio della finestra di dialogo Opzioni di Lync 2010. Quando un utente fa clic su questo pulsante, verrà effettuata una chiamata al servizio di test audio automatizzato. Questa chiamata riceve una risposta e, dopo la riproduzione di una registrazione introduttiva, al chiamante viene chiesto di registrare un breve messaggio della durata massima di 10 secondi. Questa registrazione verrà quindi riprodotta, consentendo al chiamante di verificare la qualità audio ottenuta con la connessione corrente.
Il servizio di test audio si basa in parte sugli oggetti contatto di Active Directory. Questi oggetti vengono creati automaticamente con l'installazione di Audio Bot. Non è possibile crearli manualmente. Gli amministratori tuttavia possono utilizzare il cmdlet Get-CsAudioTestServiceApplication per recuperare informazioni sui diversi contatti del servizio di test attualmente in uso nell'organizzazione. Gli amministratori possono inoltre utilizzare Set-CsAudioTestServiceApplication per modificare le proprietà di questi contatti.
Utenti autorizzati a eseguire il cmdlet: per impostazione predefinita, sono autorizzati a eseguire localmente il cmdlet Set-CsAudioTestServiceApplication 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-CsAudioTestServiceApplication"}
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
Identity |
Obbligatorio |
Parametro ID utente |
Indirizzo SIP del contatto del servizio di test audio da modificare. |
Enabled |
Facoltativo |
Booleano |
Indica se l'oggetto contatto è stato abilitato o meno per Lync Server 2010. Se questo valore viene impostato su False ($False), il contatto non potrà più accedere a Lync Server. Se il valore viene impostato su True ($True), i privilegi di accesso del contatto verranno riabilitati. |
DisplayName |
Facoltativo |
Stringa |
Nome visualizzato Active Directory dell'oggetto contatto. |
DisplayNumber |
Facoltativo |
Stringa |
Benché sia una proprietà valida, DisplayNumber non viene effettivamente utilizzata con il servizio di test audio. |
EnabledForFederation |
Facoltativo |
Booleano |
Indica se questo contatto è disponibile per gli utenti di un dominio federato. Se impostato su False, solo gli utenti all'interno dell'organizzazione avranno accesso al contatto. |
EnterpriseVoiceEnabled |
Facoltativo |
Booleano |
Indica se l'oggetto contatto è stato abilitato per VoIP aziendale, ovvero l'implementazione Microsoft di VoIP (Voice over Internet Protocol). Con VoIP aziendale, gli utenti possono effettuare telefonate via Internet anziché utilizzare la rete telefonica standard. |
LineUri |
Facoltativo |
Stringa |
Benché sia una proprietà valida, LineUri non viene effettivamente utilizzata con il servizio di test audio. |
PrimaryLanguage |
Facoltativo |
Stringa |
Lingua principale utilizzata per il servizio di test audio. La lingua deve essere configurata utilizzando uno dei codici lingua consentiti, ad esempio en-US per l'inglese americano, fr-FR per il francese e così via. Per restituire un elenco dei codici lingua disponibili, al prompt di Windows PowerShell digitare il seguente comando: Get-CsDialInConferencingLanguageList | Select-Object -ExpandProperty Languages. |
SecondaryLanguages |
Facoltativo |
Matrice di stringhe |
Benché sia una proprietà valida, SecondaryLanguages non viene effettivamente utilizzata con il servizio di test audio. |
SipAddress |
Facoltativo |
Indirizzo SIP |
Identificatore univoco che consente all'oggetto contatto di comunicare utilizzando dispositivi SIP come ad esempio Lync 2010. L'indirizzo SIP deve essere preceduto da sip:, ad esempio -SipAddress "sip:davidegarghentini@litwareinc.com". |
Type |
Facoltativo |
Stringa |
Indica il tipo di contatto di test da distribuire. Per impostazione predefinita, i contatti vengono elencati come Automaton, il che significa che possono interagire con i chiamanti. |
PassThru |
Facoltativo |
Parametro opzionale |
Consente di passare un oggetto utente attraverso la pipeline che rappresenta l'utente a cui viene assegnato il criterio. Per impostazione predefinita, il cmdlet Set-CsAudioTestServiceApplication non passa oggetti attraverso la pipeline. |
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
Set-CsAudioTestServiceApplication accetta le istanze da pipeline dell'oggetto Microsoft.Rtc.Management.ADConnect.Schema.OCSADApplicationContact.
Tipi restituiti
Set-CsAudioTestServiceApplication non restituisce alcun oggetto o valore.
Esempio
-------------------------- Esempio 1 ------------------------
Set-CsAudioTestServiceApplication -Identity "sip:RedmondAudioTest@litwareinc.com" -PrimaryLanguage "en-US"
Nell'esempio 1 la lingua principale per il contatto del servizio di test audio sip:RedmondAudioTest@litwareinc.com è impostata sull'inglese americano (en-US).
-------------------------- Esempio 2 ------------------------
Set-CsAudioTestServiceApplication -Identity "sip:RedmondAudioTest@litwareinc.com" -PrimaryLanguage $Null
Nell'esempio precedente viene annullato il valore della proprietà PrimaryLanguage per il contatto del servizio di test audio sip:RedmondAudioTest@litwareinc.com. A tale scopo, viene incluso il parametro PrimaryLanguage impostandolo su $Null.
-------------------------- Esempio 3 ------------------------
Get-CsAudioTestServiceApplication | Set-CsAudioTestServiceApplication -PrimaryLanguage "en-US"
Nell'esempio 3 i contatti del servizio di test audio in uso nell'organizzazione vengono configurati per l'utilizzo dell'inglese americano come lingua principale. A tale scopo, viene chiamato innanzitutto Get-CsAudioTestServiceApplication senza alcun parametro per restituire una raccolta dei contatti del servizio di test audio. La raccolta viene quindi inviata tramite pipe a Set-CsAudioTestServiceApplication, che imposta l'inglese americano (en-Us) come proprietà PrimaryLanguage per ogni contatto della raccolta.