Get-CsAudioTestServiceApplication
Dernière rubrique modifiée : 2012-03-23
Permet de retourner des informations sur l’application de service de test audio employée dans votre organisation.
Syntaxe
Get-CsAudioTestServiceApplication [-Identity <UserIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-OU <OUIdParameter>] [-ResultSize <Unlimited>]
Description détaillée
Le service de test audio permet aux utilisateurs Microsoft Lync 2010 de tester leurs connexions vocales avant d’effectuer un appel. Pour ce faire, les utilisateurs doivent cliquer sur le bouton Vérifier la qualité de l’appel dans l’onglet Périphérique audio de la boîte de dialogue Options de Lync 2010. Lorsqu’un utilisateur clique sur ce bouton, un appel est effectué et adressé au service de test audio automatisé. Une réponse est apportée à l’appel et, après lecture d’un texte sommaire de présentation, l’appelant est invité à enregistrer un bref message. Cet enregistrement est ensuite relu, permettant ainsi à l’appelant d’entendre la qualité de sa propre voix sur la connexion en cours.
Le service de test audio est, en partie, fondé sur des objets contact Active Directory. Ces objets sont automatiquement créés pour vous lorsque vous installez Audio Bot. Il n’existe aucun moyen de les créer manuellement. Néanmoins, les administrateurs peuvent se servir de la cmdlet Get-CsAudioTestServiceApplication pour récupérer des informations sur les différents contacts de service de test actuellement utilisés dans l’organisation. Ils peuvent aussi faire appel à la cmdlet 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 Get-CsAudioTestServiceApplication : RTCUniversalUserAdmins, RTCUniversalServerAdmins, RTCUniversalReadOnlyAdmins. 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 "Get-CsAudioTestServiceApplication"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Identity |
Facultatif |
Paramètre ID utilisateur |
Adresse SIP de votre contact du service de test audio. |
Credential |
Facultatif |
Objet Credential PS |
Permet d’exécuter la cmdlet avec d’autres informations d’identification. Ceci peut être requis si le compte que vous avez utilisé pour vous connecter à Windows ne dispose pas des privilèges nécessaires pour manipuler les objets contact. Pour utiliser le paramètre Credential, vous devez d’abord créer un objet PSCredential à l’aide de la cmdlet Get-Credential. Pour plus d’informations, consultez la rubrique d’aide de la cmdlet Get-Credential. |
DomainController |
Facultatif |
FQDN |
Vous permet de vous connecter à un contrôleur de domaine défini, afin de récupérer des informations de contact. Pour vous connecter à un contrôleur de domaine spécifique, incluez le paramètre DomainController suivi du nom de l’ordinateur (par exemple, atl-cs-001) ou de son nom de domaine complet (par exemple, atl-cs-001.litwareinc.com). |
Filter |
Facultatif |
Chaîne |
Permet de limiter les données retournées en filtrant des attributs spécifiques à Lync Server 2010. Par exemple, vous pouvez limiter les données retournées aux objets de contact de test audio qui ont un nom complet spécifique ou à qui une langue en particulier a été affectée. Le paramètre Filter utilise la même syntaxe de filtrage Windows PowerShell que celle utilisée par la cmdlet Where-Object. Par exemple, un filtre qui retourne uniquement des contacts dont le nom complet est « Audio Test Service Contacts » ressemblerait à ce qui suit, avec la propriété DisplayName représentant l’attribut Active Directory, -eq représentant l’opérateur de comparaison (égal à) et « Audio Test Service Contact » correspondant à la valeur du filtre : -Filter {DisplayName -eq "Audio Test Service Contact"} Vous ne pouvez pas utiliser à la fois les paramètres Filter et Identity dans la même commande. |
OU |
Facultatif |
Nom unique Active Directory |
Permet de retourner des contacts à partir d’une unité d’organisation (OU) Active Directory spécifique. Le paramètre OU retourne les données provenant de l’unité d’organisation (OU) spécifiée et de toutes ses unités d’organisation enfants. Par exemple, si l’unité d’organisation (OU) Finance dispose de deux unités d’organisation enfants, AccountsPayable et AccountsReceivable, les utilisateurs seront retournés depuis chacune de ces trois unités d’organisation. Lors de la spécification d’une unité d’organisation (OU), utilisez le nom unique de ce conteneur ; par exemple : -OU "OU=Finance,dc=litwareinc,dc=com"). |
ResultSize |
Facultatif |
Entier |
Permet de limiter le nombre d’enregistrements retournés par une commande. Par exemple, pour retourner sept utilisateurs (quel que soit le nombre d’utilisateurs présents dans votre forêt), incluez le paramètre ResultSize et définissez sa valeur sur 7. Notez qu’il est impossible de garantir quels seront les sept utilisateurs retournés. Si vous donnez à ResultSize la valeur 7, mais que votre forêt ne compte que trois utilisateurs, la commande retournera ces trois utilisateurs et se terminera sans erreur. La taille des résultats peut être définie sur n’importe quel entier compris entre 0 et 2147483647 (inclus). Si le paramètre est défini sur 0, la commande sera exécutée mais aucune donnée ne sera retournée. |
Types d’entrées
Aucun.
Types de retours
Get-CsAudioTestServiceApplication retourne des instances de l’objet Microsoft.Rtc.Management.ADConnect.Schema.OCSADApplicationContact.
Exemple
-------------------------- Exemple 1 ------------------------
Get-CsAudioTestServiceApplication
Dans l’exemple ci-dessus, la cmdlet Get-CsAudioTestServiceApplication est appelée sans aucun paramètre supplémentaire pour retourner une collection de tous les contacts de service de test audio actuellement utilisés dans votre organisation.
-------------------------- Exemple 2 ------------------------
Get-CsAudioTestServiceApplication -Identity "sip:RedmondAudioTest@litwareinc.com"
Dans l’exemple 2, un seul et unique contact de service de test audio est retourné : le contact dont l’identité est sip:RedmondAudioTest@litwareinc.com.
-------------------------- Exemple 3 ------------------------
Get-CsAudioTestServiceApplication -Filter {DisplayName -like "*Redmond*"}
L’exemple 3 retourne les contacts de service de test audio dont le nom complet comporte la chaîne « Redmond ». Pour ce faire, la commande utilise le paramètre Filter et la valeur de filtre {DisplayName –like "*Redmond*"}. Cette valeur de filtre limite les données retournées aux contacts dont le nom complet inclut la chaîne « Redmond ». Cette commande retourne des contacts munis de noms complets comme « Redmond Audio Test Service Contact », « Redmond Audio Bot », et « Test Contact for Redmond ».