Test-CsGroupExpansion
Dernière rubrique modifiée : 2012-03-27
Vérifie la capacité d’un utilisateur à employer un développement de groupes. Microsoft Lync Server 2010 permet aux utilisateurs de configurer un groupe de distribution Active Directory comme contact. Lorsque vous « développez » un groupe, vous voyez les noms et les informations de présence de chaque membre du groupe.
Syntaxe
Test-CsGroupExpansion -TargetFqdn <String> -GroupEmailAddress <String> [-External <SwitchParameter>] [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>] [-UserSipAddress <String>]
Test-CsGroupExpansion -GroupEmailAddress <String> -TargetUri <String> -UserSipAddress <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-WebCredential <PSCredential>]
Test-CsGroupExpansion [-TargetFqdn <String>] -GroupEmailAddress <String> -UserCredential <PSCredential> -UserSipAddress <String> [-External <SwitchParameter>] [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>]
Description détaillée
Les utilisateurs doivent parfois communiquer régulièrement avec tous les membres d’un groupe de distribution Active Directory ; par exemple, ce groupe peut comprendre tous les membres d’une équipe ou toutes les personnes affectées à un projet particulier. C’est pour cela que Lync Server 2010 permet de configurer un groupe de distribution Active Directory comme contact. En faisant cela, vous pouvez ensuite envoyer le même message instantané à tous les membres du groupe simplement en adressant le message au groupe plutôt qu’à chaque membre de ce groupe.
Vous devrez aussi parfois communiquer avec (ou vérifier la présence de) certains individus de ce groupe. Le développement de groupe permet de visualiser de manière simple et rapide les membres du groupe et leur statut. Vous pouvez en outre sélectionner un ou plusieurs membres du groupe et envoyer ensuite un message instantané à ces utilisateurs en particulier plutôt qu’à tous les membres du groupe.
Le développement de groupes est activé et désactivé à l’aide de la cmdlet Set-CsWebServiceConfiguration. Si le développement de groupes est activé, vous pouvez déterminer s’il fonctionne en exécutant la cmdlet Test-CsGroupExpansion. Avec cette cmdlet, vous spécifiez un groupe de distribution Active Directory à l’aide de l’adresse de messagerie du groupe. Test-CsGroupExpansion utilise alors le développement de groupes pour récupérer les appartenances aux groupes et comparer la liste récupérée à l’appartenance de l’adresse de messagerie du groupe que vous avez fournie. Si les deux listes correspondent, c’est que le développement de groupes fonctionne correctement.
Notez que vous pouvez vérifier le développement de groupes de deux façons différentes : en testant le service lui-même ou en testant le service Web associé.
Personnes autorisées à exécuter cette cmdlet : 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 "Test-CsGroupExpansion"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
GroupEmailAddress |
Obligatoire |
Chaîne |
Adresse de messagerie du groupe de distribution ciblé. Par exemple : -GroupEmailAddress "FinanceGroup@litwareinc.com". |
External |
Facultatif |
Paramètre de commutateur |
Permet de vérifier que les utilisateurs externes peuvent utiliser le développement de groupes. |
RegistrarPort |
Entier |
Chaîne |
Port SIP utilisé par le service Serveur d’inscriptions. Ce paramètre n’est pas obligatoire si le serveur d’inscriptions utilise le port par défaut 5061. |
TargetFqdn |
Facultatif |
Chaîne |
Nom de domaine complet (FQDN) du pool de serveurs d’inscriptions dans lequel le développement de groupes est testé. Par exemple : -TargetFqdn "atl-cs-001.litwareinc.com". Notez que vous ne pouvez pas utiliser les paramètres TargetUri et TargetFqdn dans la même commande. |
TargetUri |
Facultatif |
Chaîne |
URI (Uniform Resource Identifier) du service Web de développement du groupe. Par exemple : -TargetUri "https://atl-cs-001.litwareinc.com/groupexpansion". Notez que vous ne pouvez pas utiliser les paramètres TargetUri et TargetFqdn dans la même commande. |
UserCredential |
Facultatif |
Objet Credential PS |
Objet d’identification du compte d’utilisateur à utiliser dans le test. La valeur transmise à UserCredential doit être une référence d’objet obtenue à l’aide de la cmdlet Get-Credential. Par exemple, ce code retourne un objet d’identification pour l’utilisateur litwareinc\kenmyer et stocke cet objet dans une variable nommée $x : $x = Get-Credential "litwareinc\kenmyer" Vous devrez fournir un mot de passe utilisateur lors de l’exécution de cette commande. Les informations d’identification de l’utilisateur ne sont pas nécessaires si vous exécutez le test sous les informations d’identification de l’utilisateur connecté et si vous utilisez le paramètre TargetFqdn. Les informations d’identification de l’utilisateur sont nécessaires si vous utilisez le paramètre TargetUri. |
UserSipAddress |
Facultatif |
Chaîne |
Adresse SIP de l’utilisateur à utiliser lors du test. Si ce paramètre n’est pas spécifié, Test-CsGroupExpansion effectue ses vérifications à l’aide du compte de l’utilisateur connecté. |
WebCredential |
Facultatif |
Objet Credential PS |
Objet dans lequel sont stockées les informations d’authentification de l’utilisateur lui permettant d’accéder au service Location Information. Cet objet peut être récupéré en appelant la cmdlet Get-Credential et en fournissant les informations d’authentification appropriées. Ce paramètre est requis si les paramètres TargetUri et UserSipAddress sont spécifiés, et si l’ordinateur sur lequel vous exécutez la commande n’a pas de certificat de serveur. |
Force |
Facultatif |
Paramètre de commutateur |
Supprime l’affichage de tous les messages d’erreur récupérable susceptibles d’apparaître lors de l’exécution de la commande. |
OutVerboseVariable |
Facultatif |
Chaîne |
Lorsqu’elle est définie, la sortie détaillée de l’exécution de la cmdlet est stockée dans la variable spécifiée. Par exemple, pour stocker une sortie dans une variable nommée $TestOutput, utilisez la syntaxe suivante : -OutVerboseVariable TestOutput N’utilisez pas le caractère $ pour indiquer le nom de la variable. |
Verbose |
Facultatif |
GUID |
Crée un rapport détaillé des activités à l’écran lors de l’exécution de la cmdlet. |
Types d’entrées
Aucun. Test-CsGroupExpansion n’accepte pas la saisie de données transmises via le pipeline.
Types de retours
Test-CsGroupExpansion retourne une instance de l’objet Microsoft.Rtc.SyntheticTransactions.TaskOutput.
Exemple
-------------------------- Exemple 1 --------------------------
Test-CsGroupExpansion -TargetFqdn atl-cs-001.litwareinc.com -GroupEmailAddress FinanceGroup@litwareinc.com
La commande illustrée dans l’exemple 1 se connecte au pool de serveurs d’inscriptions pool atl-cs-001.litwareinc.com pour vérifier le développement de groupes. Pour exécuter le test, la commande utiliser le groupe FinanceGroup@litwareinc.com.