Enable-CsUser
Dernière rubrique modifiée : 2012-03-23
Active un ou plusieurs utilisateurs pour Microsoft Lync Server 2010. Tant que leurs comptes d’utilisateurs n’ont pas été activés pour Lync Server, les utilisateurs ne peuvent pas utiliser Microsoft Lync 2010 ou d’autres clients Lync Server 2010.
Syntaxe
Enable-CsUser -Identity <UserIdParameter> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-HostingProviderProxyFqdn <Fqdn>] [-PassThru <SwitchParameter>] [-ProxyPool <Fqdn>] [-RegistrarPool <Fqdn>] [-SipAddress <String>] [-SipAddressType <FirstLastName | EmailAddress | UserPrincipalName | SAMAccountName | None>] [-SipDomain <Fqdn>] [-WhatIf [<SwitchParameter>]]
Description détaillée
Pour qu’un utilisateur puisse se connecter à Lync Server, il doit remplir deux critères : il doit posséder un compte Active Directory valide qui doit être activé pour Lync Server. Il est possible d’activer un compte d’utilisateur pour Lync Server à l’aide de la cmdlet Enable-CsUser. Pour activer un compte pour Lync Server à l’aide de cette cmdlet, vous devez : 1) sélectionner le compte (ou les comptes) à activer ; 2) sélectionner un pool de serveurs d’inscriptions pour le compte et 3) attribuer une adresse SIP au compte. Lync Server permet aux administrateurs d’attribuer une adresse SIP spécifique au compte d’utilisateur. Lync Server peut également la créer automatiquement.
Personnes autorisées à exécuter cette cmdlet : Par défaut, les membres des groupes qui suivent sont autorisés à exécuter localement la cmdlet Enable-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 "Enable-CsUser"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Identity |
Obligatoire |
Paramètre ID utilisateur |
Indique l’identité du compte d’utilisateur à activer pour Lync Server. 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). 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 de chaîne « Smith ». |
RegistrarPool |
Obligatoire |
FQDN |
Indique le pool de serveurs d’inscriptions dans lequel le compte Lync Server de l’utilisateur sera hébergé. |
SipAddressType |
Facultatif |
Chaîne |
Demande à Lync Server de générer automatiquement une adresse SIP pour le nouvel utilisateur. Pour que Lync Server génère automatiquement l’adresse SIP, vous devez inclure le paramètre SipAddressType et utiliser l’une des valeurs de paramètre suivantes : FirstLastName. L’adresse SIP est constituée du prénom de l’utilisateur, d’un point, du nom de famille de l’utilisateur, puis du domaine SIP. Par exemple, l’utilisateur Ken Myer aura une adresse SIP similaire à celle-ci : Ken.Myer@litwareinc.com. Si vous utilisez ce type d’adresse, vous devez également inclure le paramètre SipDomain. EmailAddress. L’adresse de messagerie électronique de l’utilisateur (définie dans Active Directory) est utilisée en tant qu’adresse SIP. UserPrincipalName. Le nom d’utilisateur principal utilisé comme adresse SIP. SamAccountName. L’adresse SIP est le SamAccountName (nom de connexion) de l’utilisateur, suivi du domaine SIP. Par exemple, l’utilisateur ayant le SamAccountName kmyer aura une adresse SIP similaire à celle-ci : kmyer@litwareinc.com Si vous utilisez ce type d’adresse, vous devez également inclure le paramètre SipDomain. Le paramètre SipAddressType n’est pas requis si vous utilisez le paramètre SIPAddress et attribuez explicitement une adresse SIP à l’utilisateur. |
SipDomain |
Facultatif |
Chaîne |
Domaine SIP du compte d’utilisateur à activer. Ce paramètre est obligatoire si vous utilisez le paramètre SIPAddressType afin que Lync Server génère automatiquement une adresse SIP pour l’utilisateur et si vous basez les adresses SIP sur le SamAccountName, ou le prénom et le nom de l’utilisateur. Ce paramètre n’est pas requis si vous basez les adresses SIP sur l’adresse de messagerie ou le nom principal de l’utilisateur ; cela est dû au fait que le nom de domaine est déjà inclus dans ces valeurs d’attribut. |
SipAddress |
Facultatif |
Chaîne |
Vous permet d’attribuer une adresse SIP spécifique à l’utilisateur. Lorsque vous spécifiez une adresse SIP, faites-la précéder de « sip: ». Cela signifie que la valeur allouée au paramètre SipAddress doit ressembler à ceci : sip:kenmyer@litwareinc.com Le paramètre SipAddress ne doit pas être utilisé si vous utilisez SipAddressType afin que Lync Server génère automatiquement une adresse SIP pour l’utilisateur. Le paramètre SipAddress ne peut pas être utilisé si vous tentez d’activer plusieurs utilisateurs simultanément. Vous devrez générer automatiquement l’adresse SIP de ces utilisateurs au moyen du paramètre SipAddressType. |
HostingProviderProxyFqdn |
Facultatif |
Chaîne |
Ce paramètre est utilisé uniquement pour Microsoft Lync Online 2010. Il ne doit pas être utilisé avec une implémentation sur site de Lync Server. |
ProxyPool |
Facultatif |
Chaîne |
Ce paramètre est utilisé uniquement pour Lync Online 2010. Il ne doit pas être utilisé avec une implémentation sur site de Lync Server. |
DomainController |
Facultatif |
Chaîne |
Vous permet de vous connecter au contrôleur de domaine spécifié afin d’activer un compte d’utilisateur. 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). |
PassThru |
Facultatif |
Paramètre de commutateur |
Vous permet de transmettre un objet utilisateur via le pipeline qui représente le compte d’utilisateur à activer pour Lync Server. Par défaut, la cmdlet Enable-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. Enable-CsUser accepte une valeur de chaîne transmise par pipeline représentant l’identité d’un compte d’utilisateur ayant été activé pour Lync Server. La cmdlet accepte également les instances redirigées de l’objet utilisateur Active Directory.
Types de retours
Aucun. Enable-CsUser ne renvoie ni valeur ni objet. Au lieu de cela, la cmdlet configure les instances de l’objet Microsoft.Rtc.Management.ADConnect.Schema.ADUser.
Exemple
-------------------------- Exemple 1 --------------------------
Enable-CsUser -Identity "Pilar Ackerman" -RegistrarPool "atl-cs-001.litwareinc.com" -SipAddressType SamAccountName -SipDomain litwareinc.com
Dans l’exemple 1, Enable-CsUser active le compte d’utilisateur dont le nom complet est Pilar Ackerman. Dans cet exemple, l’utilisateur est affecté au pool de serveurs d’inscriptions atl-cs-001.litwareinc.com et Lync Server génère automatiquement l’adresse SIP en utilisant le SamAccountName (pilar) de l’utilisateur suivi du domaine SIP, soit litwareinc.com.
-------------------------- Exemple 2 --------------------------
Enable-CsUser -Identity "Pilar Ackerman" -RegistrarPool "atl-cs-001.litwareinc.com" -SipAddress "sip:pilar@litwareinc.com"
Dans l’exemple précédent, le compte d’utilisateur Active Directory appartenant à Pilar Ackerman est activé pour être utilisé avec Lync Server. Afin de configurer le compte pour Lync Server, les paramètres suivants sont utilisés avec la cmdlet Enable-CsUser : Identity, qui identifie le compte à activer, RegistrarPool, qui indique le serveur Standard Edition ou le pool frontal Enterprise Edition qui hébergera l’utilisateur et SipAddress, qui spécifie l’adresse SIP du nouvel utilisateur. Dans ce cas, l’adresse SIP est explicitement attribuée au lieu d’utiliser Lync Server pour la générer automatiquement.
-------------------------- Exemple 3 --------------------------
Get-CsAdUser -LDAPFilter "department=Finance" | Enable-CsUser -RegistrarPool "atl-cs-001.litwareinc.com" -SipAddressType SamAccountName -SipDomain litwareinc.com
Dans l’exemple 3, tous les utilisateurs du service Finance ont leurs comptes activés pour Lync Server. Afin d’effectuer cette tâche, la cmdlet Get-CsAdUser est utilisée avec le paramètre LDAPFilter pour renvoyer un ensemble de tous les utilisateurs qui travaillent au service Finance. Ces informations sont ensuite redirigées vers Enable-CsUser, qui active chaque compte d’utilisateur de la collection pour Lync Server.
Pour activer un compte, vous devez indiquer le pool de serveurs d’inscriptions de l’utilisateur ainsi que l’adresse SIP de ce dernier. Dans cet exemple, le pool de serveurs d’inscriptions est spécifié via le paramètre RegistrarPool. L’adresse SIP n’est toutefois pas attribuée directement. À la place, deux paramètres, SipAddressType et SipDomain, sont ajoutés à la commande. Par conséquent, une nouvelle adresse SIP constituée du SamAccountName de l’utilisateur et du nom de domaine SIP, sera automatiquement générée pour chaque compte. Par exemple, un utilisateur dont le SamAccountName est kenmyer se verra attribuer l’adresse SIP sip:kenmyer@litwareinc.com.
-------------------------- Exemple 4 --------------------------
Get-CsAdUser -Filter {Enabled -ne $True} | Enable-CsUser -RegistrarPool "atl-cs-001.litwareinc.com" -SipAddressType SamAccountName -SipDomain litwareinc.com
La commande ci-dessus active tous les utilisateurs Active Directory qui n’ont pas encore été activés pour Lync Server. Pour ce faire, la cmdlet Get-CsAdUser est appelée avec le paramètre Filter. Le filtre {Enabled -ne $True} retourne une collection de tous les utilisateurs qui n’ont pas été activés pour Lync Server. Cette collection est alors redirigée vers Enable-CsUser, qui active chaque compte, affecte l’utilisateur au pool de serveurs d’inscriptions atl-cs-001.litwareinc.com et génère automatiquement une adresse SIP pour chaque utilisateur.