Remove-CsUserAcp
Dernière rubrique modifiée : 2012-03-25
Supprime un ou plusieurs fournisseurs d’audioconférences affectés à un utilisateur ou un groupe d’utilisateurs.
Syntaxe
Remove-CsUserAcp -Identity <UserIdParameter> [-Confirm [<SwitchParameter>]] [-Name <String>] [-ParticipantPasscode <String>] [-PassThru <SwitchParameter>] [-TollNumber <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. Elle offre entre autre un moyen pour les 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 d’audioconférences 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érences. Les cmdlets CsUserAcp permettent aux administrateurs de définir un numéro de téléphone et un code secret, puis de configurer d’autres informations pouvant être utilisées pour l’intégration de fournisseurs de services d’audioconférences à 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érences n’est fournie en plus de l’attribution de valeurs de propriété.
Tout fournisseur d’audioconférences affecté à un utilisateur peut être supprimé par la suite à l’aide de la cmdlet Remove-CsUserAcp. L’appel de Remove-CsUserAcp sans paramètres (mis à part le paramètre Identity qui indique le compte d’utilisateur à modifier) supprime tous les fournisseurs d’audioconférences affectés à un utilisateur. Vous pouvez aussi utiliser les paramètres facultatifs inclus avec Remove-CsUserAcp pour supprimer les fournisseurs sélectionnés d’un compte d’utilisateur. Par exemple, cette commande recherche le compte d’utilisateur Ken Myer et supprime tous les fournisseurs d’audioconférences dont le nom est égal à « Fabrikam ACP » :
Remove-CsUserAcp –Identity "Ken Myer" –Name "Fabrikam ACP"
Pour affiner la suppression des fournisseurs d’audioconférences, incluez simplement des paramètres supplémentaires. Par exemple, cette commande supprime tous les fournisseurs d’audioconférences dont le nom est « Fabrikam ACP » et dont le numéro payant (TollNumber) est égal à « 14255551298 », comme suit :
Remove-CsUserAcp –Identity "Ken Myer" –Name "Fabrikam ACP" –TollNumber "14255551298"
Personnes autorisées à exécuter cette cmdlet : Par défaut, les membres des groupes qui suivent sont autorisés à exécuter localement la cmdlet Remove-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 "Remove-CsUserAcp"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Identity |
Obligatoire |
Identité utilisateur |
Indique l’identité du compte d’utilisateur duquel le fournisseur d’audioconférences doit être retiré. 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 ». |
Name |
Facultatif |
Chaîne |
Nom du fournisseur d’audioconférences. Par exemple : -Name "Fabrikam Conference Services". |
ParticipantPassCode |
Facultatif |
Chaîne |
Code secret requis lors de la connexion à une conférence via le fournisseur d’audioconférences. Par exemple : -PassCode "0712". |
TollNumber |
Facultatif |
Chaîne |
Numéro de téléphone payant utilisé pour les audioconférences. Par exemple : -TollNumber "14255551298". |
PassThru |
Facultatif |
Paramètre de commutateur |
Permet de transmettre un objet utilisateur via le pipeline qui représente l’utilisateur dont le fournisseur d’audioconférences est supprimé. Par défaut, la cmdlet Remove-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. Remove-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 Microsoft Lync Server 2010. La cmdlet accepte également les instances redirigées de l’objet utilisateur Active Directory.
Types de retours
Aucun.
Exemple
-------------------------- Exemple 1 ------------------------
Remove-CsUserAcp -Identity "Ken Myer"
La commande présentée dans l’exemple 1 supprime tous les fournisseurs d’audioconférences affectés à l’utilisateur Ken Myer.
-------------------------- Exemple 2 ------------------------
Get-CsUser | Remove-CsUserAcp
L’exemple 2 montre comment supprimer tous les fournisseurs d’audioconférences affectés à tous vos utilisateurs activés pour Lync Server 2010. Pour ce faire, la commande utilise d’abord Get-CsUser pour récupérer une collection de tous les utilisateurs activés pour Lync Server. Cette collection est ensuite redirigée vers la cmdlet Remove-CsUserAcp qui supprime tous les fournisseurs d’audioconférences qui ont été affectés à chaque utilisateur dans la collection.
-------------------------- Exemple 3 ------------------------
Remove-CsUserAcp -Identity "Ken Myer" -Name "Fabrikam ACP"
Dans l’exemple 3, tous les fournisseurs d’audioconférences dont le nom est « Fabrikam ACP » sont retirés du compte d’utilisateur de Ken Myer.
-------------------------- Exemple 4 ------------------------
Get-CsUserAcp | Where-Object {$_.AcpInfo -match "14255551298"} | Remove-CsUserAcp
La commande précédente supprime les fournisseurs d’audioconférences associés au numéro payant 14255551298 de tous les comptes d’utilisateur qui se sont vu affecter un fournisseur d’audioconférences. Pour cela, la commande utilise d’abord Get-CsUserAcp afin de retourner des informations sur les fournisseurs d’audioconférences affectés à tous vos utilisateurs. Ces informations sont ensuite redirigées vers la cmdlet Where-Object qui sélectionne uniquement les comptes dont la propriété AcpInfo inclut (-match) le numéro de téléphone 14255551298. Cette collection filtrée est ensuite redirigée vers la cmdlet Remove-CsUserAcp qui supprime le fournisseur d’audioconférences correspondant de chaque compte dans la collection filtrée.