Set-CsUserAcp
Dernière rubrique modifiée : 2012-03-27
Ajoute un nouveau fournisseur de services d’audioconférence à un utilisateur ou un groupe d’utilisateurs, ou bien modifie un fournisseur de services d’audioconférence existant déjà affecté à un utilisateur.
Syntaxe
Set-CsUserAcp -Identity <UserIdParameter> -Domain <String> -Name <String> -ParticipantPasscode <String> -TollNumber <String> [-Confirm [<SwitchParameter>]] [-IsDefault <$true | $false>] [-PassThru <SwitchParameter>] [-TollFreeNumbers <String[]>] [-Url <String>] [-WhatIf [<SwitchParameter>]]
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, il offre le moyen pour des utilisateurs localisé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 de services d’audioconférence 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, tout comme de configurer d’autres informations utiles à l’intégration avec les fournisseurs 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é.
Il est possible d’affecter des fournisseurs de services d’audioconférence à un compte d’utilisateur à l’aide de la cmdlet Set-CsUserAcp. (Notez que plusieurs fournisseurs de services d’audioconférence peuvent être affectés à un seul utilisateur.) Set-CsUserAcp est également utilisée pour modifier les propriétés d’un fournisseur de services d’audioconférence existant. Si vous appelez la cmdlet Set-CsUserAcp, celle-ci utilise les informations de paramètre comprises dans l’appel pour vérifier les fournisseurs de services d’audioconférence existants affectés à l’utilisateur. Si une correspondance est trouvée, le fournisseur existant est modifié. Par exemple, supposez que vous exécutez la commande suivante :
Set-CsUserAcp –Identity "Ken Myer" –TollNumber "15554251298" –ParticipantPassCode 13761 –Domain "fabrikam.com" –Name "Fabrikam ACP"
Supposez maintenant qu’un fournisseur de services d’audioconférence appelé Fabrikam ACP a déjà été affecté à l’utilisateur Ken Myer. Il a les mêmes valeurs TollNumber et Domain que celles spécifiées dans la commande. (En d’autres termes, la seule différence réside dans la valeur ParticipantPassCode.) Dans ce cas, Set-CsUserAcp modifie le fournisseur existant, c’est-à-dire Fabrikam ACP. Si une correspondance est trouvée, un nouveau fournisseur est ajouté au compte d’utilisateur de Ken Myer.
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-CsUserAcp : RTCUniversalUserAdmins. 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-CsUserAcp"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Identity |
Obligatoire |
Identité utilisateur |
Indique l’identité du compte d’utilisateur à modifier. 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). Les identités utilisateur peuvent être référencées à l’aide d’un 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 » retourne tous les utilisateurs dont le nom complet se termine par la valeur « Smith ». |
Domain |
Obligatoire |
Chaîne |
Nom de domaine du fournisseur de services d’audioconférence. Par exemple : -Domain "fabrikam.com". |
Name |
Obligatoire |
Chaîne |
Nom du fournisseur de services d’audioconférence. Par exemple : -Name "Fabrikam Conference Services". |
ParticipantPasscode |
Obligatoire |
Chaîne |
Code secret requis lors de la connexion à une conférence via le fournisseur de services d’audioconférence. Par exemple : -PassCode "0712". |
TollNumber |
Obligatoire |
Chaîne |
Numéro de téléphone payant utilisé pour les conférences audio. Par exemple : -TollNumber "14255551298". |
IsDefault |
Facultatif |
Booléen |
Indique s’il s’agit ou non du fournisseur de services d’audioconférence par défaut de l’utilisateur. Chaque utilisateur ne peut disposer que d’un fournisseur par défaut. |
TollFreeNumbers |
Facultatif |
Chaîne |
Collection de numéros de téléphone gratuits utilisés pour les conférences audio. Par exemple : -TollFreeNumbers "18005551298". Pour ajouter plusieurs numéros gratuits, séparez-les à l’aide de virgules : -TollFreeNumber "18005551298", "18005559876". |
Url |
Facultatif |
Chaîne |
URL Web du fournisseur de services d’audioconférence (par exemple : -Url "http://acp.fabrikam.com"). L’URL Web permet aux fournisseurs de services d’audioconférence de guider les utilisateurs vers une page Web contenant des numéros de téléphone de conférence rendez-vous supplémentaires, ainsi que des informations sur les services proposés par le fournisseur de services d’audioconférence. |
PassThru |
Facultatif |
Paramètre de commutateur |
Permet de transmettre un objet utilisateur via le pipeline qui représente l’utilisateur dont le fournisseur de services d’audioconférence a été supprimé. Par défaut, la cmdlet Set-CsUserAcp 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
Objet String ou Microsoft.Rtc.Management.ADConnect.Schema.ADUser. Set-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. La cmdlet accepte également les instances redirigées de l’objet utilisateur Active Directory.
Types de retours
Aucun.
Exemple
-------------------------- Exemple 1 ------------------------
Set-CsUserAcp -Identity "Ken Myer" -TollNumber "14255551298" -ParticipantPassCode 13761 -Domain "fabrikam.com" -Name "Fabrikam ACP"
Dans l’exemple 1, Set-CsUserAcp permet d’affecter un nouveau fournisseur de services d’audioconférence à l’utilisateur Ken Myer. Pour cela, le paramètre Identity est utilisé pour indiquer le compte d’utilisateur à modifier. En outre, les paramètres requis TollNumber, ParticipantPassCode, Domain et Name sont inclus avec leurs valeurs appropriées.
-------------------------- Exemple 2 ------------------------
Get-CsUser -LdapFilter "Department=Finance" | Set-CsUserAcp -TollNumber "14255551298" -ParticipantPassCode 13761 -Domain "fabrikam.com" -Name "Fabrikam ACP"
La commande présentée dans l’exemple 2 affecte le même fournisseur de services d’audioconférence à tous les utilisateurs travaillant dans le service Finance. Pour cela, la commande utilise d’abord Get-CsUser et LdapFilter (avec la valeur de filtre « Department=Finance ») pour retourner une collection de tous les utilisateurs travaillant dans le service Finance. Cette collection est ensuite redirigée vers la cmdlet Set-CsUserAcp qui affecte le même fournisseur de services d’audioconférence (Fabrikam ACP) à chaque utilisateur dans la collection.
-------------------------- Exemple 3 ------------------------
Set-CsUserAcp -Identity "Ken Myer" -TollNumber "14255551298" -ParticipantPassCode 13761 -Domain "fabrikam.com" -Name "Fabrikam ACP" -TollFreeNumbers "18005551010", "18005551020"
La commande ci-dessus affecte le fournisseur de services d’audioconférence Fabrikam ACP à l’utilisateur Ken Myer. En plus d’indiquer les paramètres TollNumber, ParticipantPassCode, Domain et Name, cette commande inclut également deux numéros de téléphone gratuits : Pour affecter ces deux valeurs, le paramètre TollFreeNumbers est inclus, suivi des deux numéros de téléphone en question séparés par une virgule.