Partager via

  • Article

Get-CsExUmContact

 

Dernière rubrique modifiée : 2012-03-23

Récupère un ou plusieurs objets contact messagerie unifiée Exchange hébergés.

Syntaxe

Get-CsExUmContact [-Identity <UserIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-LdapFilter <String>] [-OU <OUIdParameter>] [-ResultSize <Unlimited>]

Description détaillée

Microsoft Lync Server 2010 agit de concert avec messagerie unifiée Exchange pour fournir plusieurs fonctionnalités vocales dont Standard automatique et Accès abonné. Lorsque la messagerie unifiée Exchange est fournie en tant que service hébergé (plutôt que sur site), des objets contact doivent être créés à l’aide de Windows PowerShell pour appliquer les fonctionnalités Standard automatique et Accès abonné. Cette cmdlet récupère un ou plusieurs de ces contacts.

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-CsExUmContact : 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-CsExUmContact"}

Paramètres

Paramètre Obligatoire Type Description

Identity

Facultatif

Paramètre ID utilisateur

Identificateur unique de l’objet contact que vous souhaitez récupérer. Les identités de contact peuvent être spécifiées dans l’un des quatre formats suivants : 1) l’adresse SIP du contact ; 2) le nom d’utilisateur principal (UPN) du contact ; 3) le nom de domaine et le nom d’ouverture de session du contact, sous la forme domaine\ouverture de session (par exemple, litwareinc\exum1) ; et 4) le nom complet Active Directory du contact (par exemple, Standard automatique d’équipe).

Type de données complet : Microsoft.Rtc.Management.AD.UserIdParameter

Filter

Facultatif

Chaîne

Vous permet de limiter les données retournées en filtrant les attributs spécifiques à Lync Server 2010. Par exemple, vous pouvez limiter les données retournées aux contacts dont les URI de ligne commencent par tel:555.

Le paramètre Filter utilise un sous-ensemble de la syntaxe de filtrage Windows PowerShell utilisée par la cmdlet Where-Object. Par exemple, un filtre qui retourne uniquement les contacts qui ont été activés pour Enterprise Voice se présente comme suit : {EnterpriseVoiceEnabled -eq $True}, où EnterpriseVoiceEnabled correspond à l’attribut Active Directory, -eq correspond à l’opérateur de comparaison (égal à) et $True (variable Windows PowerShell intégrée) correspond à la valeur de filtre.

LdapFilter

Facultatif

Chaîne

Permet de limiter les données retournées en filtrant les attributs Active Directory « génériques » (c’est-à-dire, les attributs qui ne sont pas spécifiques de Lync Server).

Le paramètre LdapFilter utilise le langage de requête LDAP lors de la création des filtres.

Credential

Facultatif

PSCredential

Permet d’exécuter la cmdlet avec d’autres informations d’identification. Il peut être requis 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 en appelant la cmdlet Get-Credential.

DomainController

Facultatif

FQDN

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 de l’ordinateur (par exemple, atl-mcs-001) ou son nom de domaine complet (par exemple, atl-mcs-001.litwareinc.com).

Type de données complet : Microsoft.Rtc.Management.Deploy.Fqdn

OU

Facultatif

OUIdParameter

Permet de limiter les informations récupérées à partir d’une unité d’organisation (OU) Active Directory spécifique. Notez qu’il retourne les données provenant de l’unité d’organisation (OU) spécifiée et de ses unités d’organisation (OU) enfants.

Lors de la spécification d’une unité d’organisation (OU), utilisez le nom unique de ce conteneur ; par exemple : OU=ExUmContacts,dc=litwareinc,dc=com.

ResultSize

Facultatif

Entier

Permet de limiter le nombre d’enregistrements retournés par une commande. 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 sept contacts retournés. 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.

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.

Type de données complet : Microsoft.Rtc.Management.ADConnect.Core.Unlimited

Types d’entrées

Chaîne. Accepte une valeur de chaîne redirigée représentant l’identité d’un objet contact de messagerie unifiée Exchange.

Types de retours

Retourne un objet de type Microsoft.Rtc.Management.ADConnect.Schema.OCSADExUmContact.

Exemple

-------------------------- Exemple 1 --------------------------

Get-CsExUmContact

Cet exemple récupère tous les contacts messagerie unifiée Exchange définis dans un déploiement de Lync Server 2010.

-------------------------- Exemple 2 --------------------------

Get-CsExUmContact -Identity sip:exum1@fabrikam.com

Cet exemple récupère le contact messagerie unifiée Exchange dont l’adresse SIP est sip:exum1@fabrikam.com.

-------------------------- Exemple 3 --------------------------

Get-CsExUmContact -Filter {Enabled -eq $False}

Dans cet exemple, nous utilisons le paramètre Filter pour récupérer tous les contacts de messagerie unifiée Exchange qui ne sont pas activés pour Lync Server 2010. Pour ce faire, nous effectuons un filtrage sur la propriété Enabled pour voir si la valeur de cette propriété est égale (-eq) à False ($False). Les contacts retournés par cette commande ne fonctionneront pas.

-------------------------- Exemple 4 --------------------------

Get-CsExUmContact -Filter {LineURI -like "tel:555*"}

Cette commande effectue un filtrage sur la propriété LineURI afin de récupérer tous les contacts messagerie unifiée Exchange dont LineURI commence par tel:555. En d’autres termes, elle récupère tous les contacts ayant un numéro de téléphone qui commence par 555.

-------------------------- Exemple 5 --------------------------

Get-CsExUmContact -OU "OU=ExUmContacts,DC=Vdomain,DC=com"

La commande de cet exemple utilise le paramètre OU pour récupérer tous les contacts messagerie unifiée Exchange présents dans l’unité d’organisation (OU) Active Directory OU=ExUmContacts,DC=Vdomain,DC=com.