Get-CsUserAcp
Dernière rubrique modifiée : 2012-03-23
Retourne des informations sur les fournisseurs de services d’audioconférence affectés à un utilisateur ou un groupe d’utilisateurs.
Syntaxe
Get-CsUserAcp [-Identity <UserIdParameter>] [-Credential <PSCredential>] [-Filter <String>] [-LdapFilter <String>] [-ResultSize <Unlimited>]
Description détaillée
Un fournisseur de services d’audioconférence est une société tierce qui propose des services de conférence aux entreprises. Entre autres, elle permet aux utilisateurs situés hors site et non connectés au réseau de l’entreprise ou à Internet, de participer à la partie audio d’une conférence ou d’une réunion. Souvent, les fournisseurs conférence audio proposent des services haut de gamme en direct tels que la traduction, la transcription et une assistance opérateur par conférence.
Microsoft Lync Server 2010 ne permet pas une intégration complète avec les fournisseurs de services d’audioconférence. Les cmdlets CsUserAcp permettent aux administrateurs de définir un numéro de téléphone et un code secret, mais aussi de configurer d’autres informations qui pourront servir à l’intégration du fournisseur de services d’audioconférence chaque fois qu’un utilisateur planifie une réunion. Toutefois, ces cmdlets n’ayant pas été conçues pour la version hébergée sur site de Lync Server (elles sont plutôt initialement destinées à être utilisées avec Microsoft Lync Online 2010), nulle autre intégration avec les fournisseurs de services d’audioconférence n’est fournie en plus de l’attribution de valeurs de propriété.
La cmdlet Get-CsUserAcp retourne des informations sur les fournisseurs de services d’audioconférence affectés à un utilisateur ou un groupe d’utilisateurs. Pour retourner des informations sur les fournisseurs de services d’audioconférence d’un seul utilisateur, incluez simplement le paramètre Identity suivi de l’identité de l’utilisateur en question. Pour retourner des informations pour plusieurs utilisateurs, utilisez les paramètres LdapFilter ou Filter. Le paramètre LdapFilter permet d’utiliser des attributs Active Directory génériques tels que Department ou Title lorsqu’on spécifie les informations de compte d’utilisateur ; par exemple, la valeur du paramètre « Title=Comptable » restreint les informations retournées aux utilisateurs qui ont le titre de comptable. Le paramètre Filter permet d’utiliser des attributs spécifiques à Microsoft Lync Server 2010 (comme VoicePolicy ou EnterpriseVoiceEnabled) pour filtrer les données retournées. Par exemple, la valeur du filtre {EnterpriseVoiceEnabled –eq $True} limite les comptes d’utilisateur retournés par Get-CsUserAcp aux utilisateurs qui ont été activés pour Enterprise Voice.
Vous pouvez également appeler Get-CsUserAcp sans paramètre afin de retourner des informations sur les fournisseurs de services d’audioconférence de tous vos utilisateurs. Notez que Get-CsUserAcp retourne des informations sur les fournisseurs de services d’audioconférence pour tous vos utilisateurs, y compris ceux qui n’ont pas été activés pour Lync Server.
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-CsUserAcp : RTCUniversalUserAdmins, 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-CsUserAcp"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Identity |
Facultatif |
Identité utilisateur |
Indique l’identité du compte d’utilisateur à récupérer. Vous pouvez spécifier une identité d’utilisateur dans l’un des quatre formats suivants : 1) L’adresse SIP de l’utilisateur ; 2) Le nom d’utilisateur principal de l’utilisateur ; 3) Le nom de domaine et le nom d’ouverture de session de l’utilisateur, sous la forme domaine\ouverture de session (par exemple, litwareinc\kenmyer) ; et 4) Le nom complet services de domaine Active Directory (AD DS) de l’utilisateur (par exemple, Ken Myer). Vous pouvez également faire référence à un compte d’utilisateur en utilisant son nom unique Active Directory. Vous pouvez recourir à l’astérisque (caractère générique *) si vous utilisez le nom complet comme identité utilisateur. Par exemple, l’identité « * Smith » renvoie tous les utilisateurs dont le nom complet se termine par la valeur « Smith ». |
Credential |
Facultatif |
Objet Credential PS |
Permet d’exécuter la cmdlet Get-CsUserAcp 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. |
Filter |
Facultatif |
Chaîne |
Vous permet de limiter les données retournées en filtrant les attributs spécifiques à Lync Server. Par exemple, vous pouvez limiter les données retournées aux utilisateurs auxquels une stratégie de voix spécifique a été attribuée ou aux utilisateurs auxquels aucune stratégie de voix spécifique n’a été attribuée. Le paramètre Filter utilise la même syntaxe de filtrage Windows PowerShell que celle employée par la cmdlet Where-Object. Par exemple, un filtre qui retourne uniquement les utilisateurs qui ont été activés pour Enterprise Voice ressemblerait à ceci, avec EnterpriseVoiceEnabled représentant l’attribut des services de domaine Active Directory (AD DS) , - eq représentant l’opérateur de comparaison (égal à) et $True (variable intégrée de Windows PowerShell) représentant la valeur du filtre : {EnterpriseVoiceEnabled -eq $True} |
LdapFilter |
Facultatif |
Chaîne |
Permet de limiter les données retournées en filtrant les attributs Active Directory génériques (c’est-à-dire les attributs qui ne sont pas spécifiques à Lync Server). Par exemple, vous pouvez limiter les données retournées aux utilisateurs qui travaillent dans un service donné ou aux utilisateurs qui ont un responsable ou une fonction spécifique. Le paramètre LdapFilter utilise le langage de requête LDAP lors de la création des filtres. Par exemple, un filtre qui retourne uniquement les utilisateurs travaillant dans la ville de Redmond se présente comme suit : « l=Redmond », où « l » (soit un L minuscule) correspond à l’attribut Active Directory (localité), « = » correspond à l’opérateur de comparaison (égal à) et « Redmond » correspond à la valeur de filtre. |
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 savoir quels seront les 7 utilisateurs retournés. Si vous définissez ResultSize sur 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 s’exécutera, mais aucune donnée ne sera retournée. |
Types d’entrées
Chaîne. Get-CsUserAcp accepte une valeur de chaîne transmise via le pipeline représentant l’identité d’un compte d’utilisateur qui a été activé pour Lync Server 2010.
Types de retours
Get-CsUserAcp retourne les instances de l’objet Microsoft.Rtc.Management.ADConnect.Schema.ADUserAcp.
Exemple
-------------------------- Exemple 1 ------------------------
Get-CsUserAcp
La commande présentée dans l’exemple 1 retourne des informations sur les fournisseurs de services d’audioconférence de tous les utilisateurs de votre organisation.
-------------------------- Exemple 2 ------------------------
Get-CsUserAcp -Identity "Ken Myer"
La commande précédente retourne des informations sur les fournisseurs de services d’audioconférence d’un seul utilisateur : l’utilisateur dont l'identité est Ken Myer. Dans ce cas, l’identité est spécifiée en utilisant le nom complet Active Directory de l’utilisateur.
-------------------------- Exemple 3 ------------------------
Get-CsUserAcp -Filter {AcpInfo -ne $Null}
L’exemple 3 retourne des informations pour tous les utilisateurs qui se sont vu affecter au moins un fournisseur de services d’audioconférence. Pour ce faire, le paramètre Filter est inclus avec la valeur de filtre {AcpInfo –ne $Null} ; cette valeur de filtre limite les données retournées aux utilisateurs dont la valeur de propriété AcpInfo est différente d’une valeur Null. Pour retourner des informations sur les utilisateurs qui ne se sont pas vu affecter de fournisseur de services d’audioconférence, utilisez cette valeur de filtre :
{AcpInfo –eq $Null}
-------------------------- Exemple 4 ------------------------
Get-CsUserAcp | Where-Object {$_.AcpInfo -match "Fabrikam ACP"
La commande précédente retourne des informations sur les fournisseurs de services d’audioconférence pour tout utilisateur qui s’est vu attribuer le fournisseur Fabrikam ACP. Pour effectuer cette tâche, la commande utilise d’abord Get-CsUserAcp sans paramètre afin de retourner des informations sur les fournisseurs de services d’audioconférence de tous les utilisateurs de votre organisation. Ces informations sont ensuite redirigées vers la cmdlet Where-Object qui sélectionne tout utilisateur dont la propriété AcpInfo inclut (-match) la valeur de chaîne "Fabrikam ACP".
-------------------------- Exemple 5 ------------------------
Get-CsUserAcp -Identity "Ken Myer" | Select-Object -ExpandProperty AcpInfo
Dans l’exemple 5, des informations détaillées s’affichent sur les fournisseurs de services d’audioconférence affectés à l’utilisateur Ken Myer. Pour ce faire, Get-CsUserAcp est tout d’abord appelée pour retourner des informations sur les fournisseurs de services d’audioconférence de Ken Myer. Ces données sont ensuite redirigées vers la cmdlet Select-Object qui utilise le paramètre ExpandProperty pour « développer » la valeur de la propriété AcpInfo. Lorsqu’une valeur de propriété est développée, cela signifie que toutes les informations stockées dans cette valeur s’affichent à l’écran dans un format lisible.