Set-CsUser
Dernière rubrique modifiée : 2012-03-26
Modifie les propriétés Microsoft Lync Server 2010 d’un compte d’utilisateur existant. Les propriétés ne peuvent être modifiées que pour les comptes qui ont été activés pour être utilisés avec Lync Server 2010.
Syntaxe
Set-CsUser -Identity <UserIdParameter> [-AcpInfo <MultiValuedProperty>] [-AudioVideoDisabled <$true | $false>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Enabled <$true | $false>] [-EnterpriseVoiceEnabled <$true | $false>] [-HostedVoiceMail <Nullable>] [-LineServerURI <String>] [-LineURI <String>] [-PassThru <SwitchParameter>] [-PrivateLine <String>] [-RemoteCallControlTelephonyEnabled <$true | $false>] [-SipAddress <String>] [-WhatIf [<SwitchParameter>]]
Description détaillée
Set-CsUser vous permet de modifier les attributs du compte d’utilisateur associé à Lync Server, qui sont stockés dans services de domaine Active Directory (AD DS). Par exemple, vous pouvez désactiver ou réactiver un utilisateur sous Lync Server, activer ou désactiver un utilisateur pour les communications audio/vidéo (A/V), mais aussi modifier la ligne privée d’un utilisateur et les numéros URI (Uniform Resource Identifier) de la ligne. Set-CsUser ne peut être utilisé que pour les utilisateurs qui ont été activés pour Lync Server.
Les seuls attributs que vous pouvez modifier à l’aide de Set-CsUser sont ceux liés à Lync Server. Les autres attributs de compte d’utilisateur, tels que la fonction ou le service de l’utilisateur, ne peuvent pas être modifiés à l’aide de cette cmdlet.
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-CsUser : 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-CsUser\b"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Identity |
Obligatoire |
XdsIdentity |
Indique l’identité du compte d’utilisateur à modifier. Les identités utilisateur peuvent être spécifiées 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 Active Directory 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 » renvoie tous les utilisateurs dont le nom complet se termine par la valeur de chaîne « Smith ». |
ACPInfo |
Facultatif |
Groupe d’objets ACPInfo |
Permet d’attribuer un ou plusieurs fournisseurs tiers de solutions de conférence audio à un utilisateur. Cependant, il est recommandé d’utiliser la cmdlet Set-UserAcp pour affecter des fournisseurs de solutions de conférence audio. |
AudioVideoDisabled |
Facultatif |
Booléen |
Indique si l’utilisateur est autorisé à passer des appels audio/vidéo (A/V) via Lync 2010. Si la valeur est True, l’utilisateur n’aura le choix que d’envoyer ou de recevoir des messages instantanés. Vous ne pouvez pas désactiver les communications A/V si un utilisateur est activé pour le contrôle d’appel distant, Enterprise Voice et/ou le routage Softphone d’autocommutateur privé IP-PBX (Internet Protocol private branch exchange). |
Enabled |
Facultatif |
Booléen |
Indique si l’utilisateur a été activé sous Lync Server. Si vous configurez cette valeur sur False, l’utilisateur ne pourra plus se connecter à Lync Server ; si vous définissez cette valeur sur True, vous réactivez les privilèges de connexion de l’utilisateur. Si vous désactivez un compte à l’aide du paramètre Enabled, les informations associées à ce compte (notamment les stratégies affectées et si l’utilisateur est activé ou non pour Enterprise Voice Entreprise, et/ou le contrôle d’appel distant) sont conservées. Si, par la suite, vous réactivez le compte en utilisant le paramètre Enabled, les informations associées à ce compte seront restaurées. Cette action est différente de la cmdlet Disable-CsUser qui permet de désactiver un compte d’utilisateur. Lorsque vous exécutez Disable-CsUser, toutes les données Lync Server associées à ce compte sont supprimées. |
DomainController |
Facultatif |
Chaîne |
Permet de spécifier le contrôleur de domaine avec lequel vous souhaitez établir une connexion au moment de modifier un compte d’utilisateur. Si ce paramètre n’est pas inclus, la cmdlet utilisera le premier contrôleur de domaine disponible. |
EnterpriseVoiceEnabled |
Facultatif |
Booléen |
Indique si l’utilisateur 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. |
HostedVoiceMail |
Facultatif |
Booléen |
Avec une valeur True, permet de router les appels de messagerie vocale d’un utilisateur vers une version hébergée de Microsoft Exchange Server. De plus, le fait de définir cette option sur True permet aux utilisateurs Lync 2010 de passer directement des appels à une autre boîte vocale d’utilisateur. |
LineURI |
Facultatif |
Chaîne |
Numéro de téléphone affecté à l’utilisateur. L’URI (Uniform Resource Identifier) de la ligne doit être spécifié au format E.164 et doté du préfixe « TEL: » . Par exemple : TEL:+14255551297. Tout numéro de poste doit être ajouté à la fin de l’URI de ligne ; par exemple : TEL:+14255551297; ext=51297. Il est important de noter que Lync Server traite TEL:+14255551297 et TEL:+14255551297;ext=51297 comme deux numéros différents. Si vous affectez à Ken Myer la ligne URI TEL:+14255551297 et si vous tentez ultérieurement d’affecter à Pilar Ackerman la ligne URI TEL:+14255551297;ext=51297, cette affectation réussit ; le numéro affecté à Pilar n’est pas marqué avec un indicateur de numéro dupliqué. Cela est dû au fait que, selon votre configuration, ces deux numéros peuvent en fait être distincts. Par exemple, dans certaines organisations, si vous composez 1-425-555-1297, votre appel est acheminé vers un standard automatique Exchange. À l’inverse, si vous composez juste l’extension (51297) ou si vous utilisez Microsoft Lync 2010 pour composer le numéro 1-425-555-1297, l’extension 51297 achemine votre appel directement vers l’utilisateur. |
LineServerURI |
Facultatif |
Chaîne |
URI de la passerelle téléphonique de contrôle d’appel distant attribué à l’utilisateur. LineServerUri est l’URI de la passerelle, précédé de « sip: ». Par exemple : sip:rccgateway@litwareinc.com |
PrivateLine |
Facultatif |
Chaîne |
Numéro de la ligne de téléphone privée de l’utilisateur. Une ligne privée est un numéro de téléphone qui n’est pas publié dans les services de domaine Active Directory (AD DS) et qui n’est donc pas disponible pour les autres utilisateurs. En outre, cette ligne privée ignore la plupart des règles de routage des appels entrants ; par exemple, un appel vers une ligne privée ne sera pas transféré aux délégués d’une personne. Les lignes privées sont souvent utilisées pour les appels téléphoniques personnels ou pour les appels professionnels qui ne concernent pas les autres membres de l’équipe. La ligne privée doit être spécifiée avec le format E.164 et doit être signalée par le préfixe « TEL: » inclus. Par exemple : TEL:+14255551297. |
RemoteCallControlTelephonyEnabled |
Facultatif |
Booléen |
Indique si l’utilisateur a été activé pour la téléphonie de contrôle d’appel distant. Si elle est activée pour le contrôle d’appel distant, un utilisateur peut avoir recours à Lync Server pour répondre aux appels téléphoniques sur son téléphone de bureau. Les appels téléphoniques peuvent aussi être passés via Lync 2010. Ces appels utilisent tous le réseau téléphonique standard, également appelé réseau téléphonique commuté (PSTN). Pour passer et recevoir des appels téléphoniques sur Internet, l’utilisateur doit être activé pour Enterprise Voice. Pour plus d’informations, consultez le paramètre EnterpriseVoiceEnabled. Pour être activé pour le contrôle d’appel distant, un utilisateur doit avoir à la fois un LineUri et un LineServerUri. |
SipAddress |
Facultatif |
Chaîne |
Identificateur unique (similaire à une adresse de messagerie électronique) qui permet à l’utilisateur de communiquer via des périphériques SIP tels que Lync 2010. L’adresse SIP doit utiliser le préfixe :sip ainsi qu’un domaine SIP valide. Par exemple : -SipAddress sip:kenmyer@litwareinc.com. |
PassThru |
Facultatif |
Paramètre de commutateur |
Vous permet de transférer sur le pipeline un objet d’utilisateur qui représente l’utilisateur dont le compte a été modifié. Par défaut, la cmdlet Set-CsUser 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-CsUser 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. La cmdlet accepte également les instances redirigées de l’objet utilisateur Active Directory.
Types de retours
Set-CsUser ne renvoie aucun objet.
Exemple
-------------------------- Exemple 1 --------------------------
Set-CsUser -Identity "Pilar Ackerman" -EnterpriseVoiceEnabled $True
Dans l’exemple 1, Set-CsUser permet de modifier le compte d’utilisateur dont l’identité est Pilar Ackerman. Dans ce cas, le compte est modifié pour activer Enterprise Voice, l’implémentation Microsoft du protocole VoIP. Pour effectuer cette tâche, ajoutez le paramètre EnterpriseVoiceEnabled, puis définissez la valeur du paramètre sur $True.
-------------------------- Exemple 2 --------------------------
Get-CsUser -LdapFilter "Department=Finance" | Set-CsUser -EnterpriseVoiceEnabled $True
Dans l’exemple 2, tous les utilisateurs du service Finance ont leurs comptes activés pour Enterprise Voice. Dans cette commande, la cmdlet Get-CsUser et LDAPFilter sont d’abord utilisés pour renvoyer un regroupement de tous les utilisateurs qui travaillent au service Finance. Ces informations sont ensuite redirigées vers Set-CsUser, qui active Enterprise Voice pour chaque compte contenu dans le regroupement.