Set-CsAudioTestServiceApplication
Dernière rubrique modifiée : 2012-03-27
Permet de modifier les valeurs de propriété pour tous les contacts d'application de service de test audio actuellement utilisés dans votre organisation.
Syntaxe
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>]]
Description détaillée
Le service de test audio permet aux utilisateurs de Microsoft Lync 2010 de tester leurs liaisons voix avant d'effectuer un appel. Pour ce faire, ils cliquent sur le bouton Vérifier la qualité des appels dans l'onglet Périphérique audio de la boîte de dialogue Options Lync 2010. Lorsqu'un utilisateur clique sur ce bouton, un appel est effectué au service de test audio automatisé. L'appel est pris et, après une invite d'introduction, il est demandé à l'appelant d'enregistrer un bref message (10 secondes maximum). Cet enregistrement est ensuite lu, ce qui permet à l'appelant d'entendre la qualité de sa propre voix sur la liaison actuelle.
Le service de test audio repose en partie sur des objets de contact Active Directory. Ces objets sont automatiquement créés pour vous lorsque vous installez Audio Bot ; il est impossible de les créer manuellement. Toutefois, les administrateurs peuvent utiliser la cmdlet Get-CsAudioTestServiceApplication pour récupérer les informations concernant les différents contacts de service de test de votre organisation. Les administrateurs peuvent également utiliser Set-CsAudioTestServiceApplication pour modifier les propriétés de ces contacts.
Personnes autorisées à exécuter cette cmdlet : Par défaut, les membres des groupes qui suivent sont autorisés à exécuter localement la cmdlet Set-CsAudioTestServiceApplication : RTCUniversalServerAdmins. Pour retourner une liste de tous les rôles RBAC (Contrôle d'accès basé sur un rôle) auxquels cette cmdlet a été affectée (y compris les rôles RBAC personnalisés créés par vos soins), exécutez la commande suivante à l'invite Windows PowerShell :
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsAudioTestServiceApplication"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Identity |
Obligatoire |
UserIDParameter |
Adresse SIP du contact de service de test audio à modifier. |
Enabled |
Facultatif |
Booléen |
Indique si l'objet contact a été activé pour Lync Server 2010. Si vous définissez cette valeur sur False ($False), le contact ne pourra plus se connecter à Lync Server ; si vous définissez cette valeur sur True ($True), vous réactivez les privilèges de connexion du contact. |
DisplayName |
Facultatif |
Chaîne |
Nom complet Active Directory du nouvel objet contact. |
DisplayNumber |
Facultatif |
Chaîne |
Bien qu'il s'agisse d'une propriété valide, DisplayNumber n'est actuellement pas utilisé avec le service de test audio. |
EnabledForFederation |
Facultatif |
Booléen |
Indique si ce contact est disponible pour les utilisateurs d'un domaine fédéré. Si défini sur False, seuls les utilisateurs au sein de votre organisation auront accès au contact. |
EnterpriseVoiceEnabled |
Facultatif |
Booléen |
Indique si l'objet contact a été activé pour Enterprise Voice, qui est l'implémentation Microsoft du protocole VoIP (Voice over Internet Protocol). Avec Enterprise Voice, les utilisateurs peuvent passer des appels téléphoniques via Internet au lieu d'utiliser le réseau téléphonique standard. |
LineUri |
Facultatif |
Chaîne |
Bien qu'il s'agisse d'une propriété valide, LineUri n'est actuellement pas utilisé avec le service de test audio. |
PrimaryLanguage |
Facultatif |
Chaîne |
Principale langue utilisée pour le service de test audio. La langue doit être configurée à l'aide de l'un des codes linguistiques autorisés ; par exemple, en-US pour l'anglais américain ; fr-FR pour le français ; etc. Pour retourner une liste de tous les codes linguistiques disponibles, tapez la commande suivante à l'invite Windows PowerShell : Get-CsDialInConferencingLanguageList | Select-Object -ExpandProperty Languages. |
SecondaryLanguages |
Facultatif |
Tableau de chaînes |
Bien qu'il s'agisse d'une propriété valide, SecondaryLanguages n'est actuellement pas utilisé avec le service de test audio. |
SipAddress |
Facultatif |
Adresse SIP |
Identificateur unique qui permet à l'objet contact de communiquer via des périphériques SIP tels que Lync 2010. L'adresse SIP doit être précédé de sip:; par exemple : -SipAddress "sip:kenmyer@litwareinc.com". |
Type |
Facultatif |
Chaîne |
Indique le type de contact de test déployé. Par défaut, les contacts sont répertoriés comme Automate, ce qui signifie qu'ils peuvent interagir avec les appelants. |
PassThru |
Facultatif |
Paramètre de commutateur |
Permet de transmettre un objet d’utilisateur via le pipeline qui représente l’utilisateur auquel la stratégie est affectée. Par défaut, la cmdlet Set-CsAudioTestServiceApplication ne transmet aucun objet via le pipeline. |
WhatIf |
Facultatif |
Paramètre de commutateur |
Décrit ce qui se passe si vous exécutez la commande sans l’exécuter réellement. |
Confirm |
Facultatif |
Paramètre de commutateur |
Vous demande confirmation avant d’exécuter la commande. |
Types d’entrées
Set-CsAudioTestServiceApplication accepte les instances de l'objet Microsoft.Rtc.Management.ADConnect.Schema.OCSADApplicationContact transmises via le pipeline.
Types de retours
Set-CsAudioTestServiceApplication ne retourne ni objet, ni valeur.
Exemple
-------------------------- Exemple 1 ------------------------
Set-CsAudioTestServiceApplication -Identity "sip:RedmondAudioTest@litwareinc.com" -PrimaryLanguage "en-US"
Dans l'exemple 1, la langue principale du contact du service de test audio contact sip:RedmondAudioTest@litwareinc.com a été définie sur anglais américain (en-US).
-------------------------- Exemple 2 ------------------------
Set-CsAudioTestServiceApplication -Identity "sip:RedmondAudioTest@litwareinc.com" -PrimaryLanguage $Null
Dans l'exemple précédent, la valeur de la propriété PrimaryLanguage a été remise à zéro pour le ocntact de service de test audio sip:RedmondAudioTest@litwareinc.com. Cette opération s'effectue en incluant le paramètre PrimaryLanguage et en le paramétrant sa valeur sur $Null.
-------------------------- Exemple 3 ------------------------
Get-CsAudioTestServiceApplication | Set-CsAudioTestServiceApplication -PrimaryLanguage "en-US"
Dans l'exemple 3, tous les contacts du service de test audio utilisés au sein de l'organisation sont configurés comme ayant l'anglais américain comme langue principale. Pour cela, Get-CsAudioTestServiceApplication est d'abord appelé sans paramètre afin de retourner une collection des contacts de service de test audio. Cette collection est ensuite transmise via le pipeline à Set-CsAudioTestServiceApplication, qui attribue l'anglais américain (en-Us) à la propriété PrimaryLanguage de chaque contact de la collection.