Get-CsAdContact
Dernière rubrique modifiée : 2012-03-23
Dans une topologie à plusieurs forêts, cette cmdlet retourne des informations sur les comptes d’utilisateurs appartenant à des forêts autres que votre propre forêt. Ces utilisateurs ont été répliqués en tant qu’objets contact par le gestionnaire d’identité de Microsoft Forefront 2010 (ou une version précédente). Get-CsAdContact retourne tout utilisateur ayant une valeur configurée pour l’attribut msRTCSIP-OriginatorSid.
Syntaxe
Get-CsAdContact [-Identity <UserIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-LDAPFilter <String>] [-OU <OUIdParameter>] [-ResultSize <Unlimited>]
Description détaillée
Dans une topologie multi-forêts, les utilisateurs des autres forêts sont représentés comme étant des contacts. Ces contacts ne sont pas équivalents aux contacts Active Directory. Si vous utilisez le composant Utilisateurs et ordinateurs Active Directory pour créer un nouveau contact, cet utilisateur ne sera pas retourné par la cmdlet Get-CsAdContact. Au lieu de cela, Get-CsAdContact retourne uniquement des informations sur les utilisateurs issus de forêts autres que votre forêt. Si vous ne disposez pas d’une topologie multi-forêts, vous devrez appeler Get-CsAdContact.
Personnes autorisées à exécuter cette cmdlet : Par défaut, les membres des groupes qui suivent sont autorisés à exécuter localement la cmdlet Get-CsAdContact : RTCUniversalUserAdmins, RTCUniversalServerAdmins, RTCUniversalReadOnlyAdmins. 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 "Get-CsAdContact"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Identity |
Facultatif |
Paramètre UserId |
Indique l’identité du contact à retourner. Les identités des contacts peuvent être spécifiées dans l’un des trois formats suivants : 1) L’adresse SIP du contact ; 2) Le nom unique Active Directory du contact ; et 3) Le nom complet Active Directory du contact (par exemple Ken Myer). Vous pouvez recourir à l’astérisque (caractère générique *) si vous utilisez le nom complet comme identité de contact. Par exemple, l’identité « * Smith » renvoie tous les contacts dont le nom complet se termine par la valeur « Smith ». |
Credential |
Facultatif |
Objet Credential PS |
Permet d’exécuter la cmdlet Get-CsAdContact avec d’autres informations d’identification. Ce paramètre peut être indispensable si le compte que vous avez utilisé pour vous connecter à Windows ne dispose pas des privilèges nécessaires pour manipuler les objets contact. Pour utiliser le paramètre Credential, vous devez d’abord créer un objet PSCredential à l’aide de la cmdlet Get-Credential. Pour plus d’informations, consultez la rubrique d’aide relative à la cmdlet Get-Credential. |
DomainController |
Facultatif |
Chaîne |
Permet de vous connecter au contrôleur de domaine spécifié, afin de récupérer des informations de contact. Pour vous connecter à un contrôleur de domaine spécifique, incluez le paramètre DomainController suivi du nom complet (par exemple, atl-cs-001.litwareinc.com). |
Filter |
Facultatif |
Chaîne |
Vous permet de limiter les données retournées en filtrant les attributs spécifiques de Microsoft Lync Server 2010. Le paramètre Filter utilise la même syntaxe de filtrage Windows PowerShell que celle utilisée par la cmdlet Where-Object. Par exemple, un filtre qui retourne uniquement les contacts dont l’adresse SIP se termine par "fabrikam.com" ressemblerait à : {SipAddress -like "*@fabrikam.com"}, où SipAddress désigne l’attribut Active Directory, -like représente l’opérateur de comparaison, et "*@fabrikam.com" représente la valeur de filtre. |
LdapFilter |
Facultatif |
Chaîne |
Vous permet de limiter les données retournées en filtrant les attributs Active Directory génériques. Par exemple, vous pouvez limiter les données retournées aux contacts qui travaillent dans un service donné ou aux contacts qui ont un responsable ou une fonction spécifique. Le paramètre LdapFilter utilise le langage de requête LDAP lors de la création des filtres. Par exemple, un filtre qui retourne le contact associé au numéro de téléphone 1-425-555-1298 ressemblerait à : "telephoneNumber=1-425-555-1298", où "telephoneNumber" désigne l’attribut Active Directory, "=" correspond à l’opérateur de comparaison (égal à) et "1-425-555-1298" représente la valeur de filtre. |
OU |
Facultatif |
Nom unique |
Permet de limiter les informations récupérées à partir d’une unité d’organisation (OU) ou d’un conteneur Active Directory spécifiques. Il retourne les paramètres provenant de l’unité d’organisation (OU) spécifiée et de toutes ses unités d’organisation enfants. Par exemple, l’unité d’organisation Finance a deux unités d’organisation enfants : AccountsPayable et AccountsReceivable. Ces deux unités d’organisation retournent des contacts. Lors de la spécification d’une unité d’organisation, utilisez le nom unique de ce conteneur. Exemple : OU=Finance,dc=litwareinc,dc=com. |
ResultSize |
Facultatif |
Entier |
Permet de limiter le nombre d’enregistrements retournés par la cmdlet. Par exemple, pour retourner sept contacts (quel que soit le nombre de contacts présents dans votre forêt), incluez le paramètre ResultSize et définissez sa valeur sur 7. Notez qu’il est impossible de savoir quels seront les 7 utilisateurs retournés. La taille des résultats peut être définie sur n’importe quel entier compris entre 0 et 2147483647 (inclus). Si le paramètre est défini sur 0, la commande s’exécutera, mais aucune donnée ne sera retournée. Si vous définissez ResultSize sur 7, mais que votre forêt ne compte que trois contacts, la commande retournera ces trois contacts et se terminera sans erreur. |
Types d’entrées
Chaîne. Get-CsAdContact accepte une valeur de chaîne redirigée représentant l’identité d’un compte d’utilisateur.
Types de retours
Get-CsAdContact retourne des instances de l’objet Microsoft.Rtc.Management.ADConnect.Schema.ADContact.
Exemple
-------------------------- Exemple 1 ------------------------
Get-CsAdContact
La commande illustrée dans l’exemple 1 retourne une collection de tous les contacts multi-forêts localisés dans services de domaine Active Directory (AD DS). Le fait d’appeler Get-CsAdContact sans paramètres supplémentaires retourne toutes les valeurs de propriété de tous les contacts Active Directory.
-------------------------- Exemple 2 ------------------------
Get-CsAdContact | Select-Object DisplayName, SipAddress
L’exemple 2 retourne une collection de tous les contacts Active Directory. Dans ce cas toutefois, cette collection est redirigée vers la cmdlet Select-Object, qui spécifie les deux seuls attributs affichés sur l’écran : DisplayName et SipAddress.
-------------------------- Exemple 3 ------------------------
Get-CsAdContact -Identity "Ken Myer"
La commande ci-dessus retourne des informations pour un seul contact Active Directory : le contact dont l’identité est "Ken Myer".
-------------------------- Exemple 4 ------------------------
Get-CsAdContact -LdapFilter "Organization=Fabrikam"
Dans l’exemple 4, la commande retourne tous les contacts Active Directory qui travaillent pour Fabrikam. Pour ce faire, la cmdlet Get-CsAdContact est appelée avec le paramètre LdapFilter. Dans cet exemple, la cmdlet limite les données retournées aux contacts dont l’attribut Organization est défini sur "Fabrikam".
-------------------------- Exemple 5 ------------------------
$x = Get-Credential -Credential "litwareinc\administrator"
Get-CsAdContact -Credential $x
Les deux commandes présentées dans l’exemple 5 illustrent l’utilisation du paramètre Credential, qui permet d’exécuter Get-CsAdContact sous d’autres informations d’identification. Dans la première commande, la cmdlet Get-Credential est appelée pour créer un objet PSCredential pour le compte litwareinc\administrator. Cette commande affiche la boîte de dialogue Demande d’informations d’identification pour l’utilisateur litwareinc\administrator. Une fois que vous avez indiqué le mot de passe de ce compte, les informations d’identification sont stockées dans la variable $x. Dans la seconde commande, Get-CsAdContact est appelée avec le paramètre Credential. La valeur de paramètre $x indique que la cmdlet Get-CsAdContact doit être exécutée sous le compte litwareinc\administrator.