Partager via

Get-MsolContact

  • Référence
Module:
MSOnline

Obtient les contacts d’Azure Active Directory.

Syntaxe

Get-MsolContact
   [-HasErrorsOnly <Boolean>]
   [-SearchString <String>]
   [-MaxResults <Int32>]
   [-TenantId <Guid>]
   [<CommonParameters>]
Get-MsolContact
   -ObjectId <Guid>
   [-TenantId <Guid>]
   [<CommonParameters>]
Get-MsolContact
   [-HasErrorsOnly <Boolean>]
   [-SearchString <String>]
   [-All]
   [-TenantId <Guid>]
   [<CommonParameters>]

Description

L’applet de commande Get-MsolContact obtient un objet contact ou une liste de contacts. Spécifiez le paramètre ObjectId pour obtenir un seul contact.

Exemples

Exemple 1 : Obtenir un contact

PS C:\> Get-MsolContact -ObjectId adc41dc7-4130-4215-adfb-2403bc9f844e

Cette commande récupère un contact.

Exemple 2 : Obtenir des contacts qui correspondent à une chaîne

PS C:\> Get-MsolContact -SearchString "Patti"

Cette commande récupère une liste de contacts avec un nom complet ou une adresse e-mail commençant par Patti.

Paramètres

-All

Indique que cette applet de commande retourne tous les résultats qu’elle trouve. Ne spécifiez pas ce paramètre et le paramètre MaxResults .

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-HasErrorsOnly

Indique que cette applet de commande retourne des contacts qui ont des erreurs de validation.

Type:Boolean
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-MaxResults

Spécifie le nombre maximal de résultats retournés par cette applet de commande. La valeur par défaut est 500.

Type:Int32
Position:Named
Valeur par défaut:500
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ObjectId

Spécifie l’ID d’objet unique du contact à obtenir.

Type:Guid
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-SearchString

Spécifie une chaîne. Cette applet de commande retourne des contacts avec un nom complet ou une adresse e-mail qui commencent par cette chaîne.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-TenantId

Spécifie l’ID unique du locataire sur lequel effectuer l’opération. La valeur par défaut est le locataire de l’utilisateur actuel. Ce paramètre s’applique uniquement aux utilisateurs partenaires.

Type:Guid
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

Sorties

Microsoft.Online.Administration.Contact

Cette applet de commande retourne des objets contact, qui incluent les informations suivantes :

  • City. ville du contact.

  • Pays. Pays ou région du contact.

  • Département. Service du contact.

  • DisplayName. Nom d’affichage du contact.

  • Fax. numéro de télécopie du contact.

  • Prénom. Prénom du contact.

  • LastDirSyncTime. renvoie la date et l'heure de la dernière synchronisation (valeurs renvoyées uniquement par les contacts synchronisés à Active Directory).

  • LastName. Nom du contact.

  • MobilePhone. Numéro de téléphone mobile du contact.

  • Objectid. ID unique du contact.

  • Bureau. numéro de téléphone fixe du contact.

  • Numéro de téléphone. Numéro de téléphone du contact.

  • Code postal. code postal du contact.

  • Adresses proxy. Adresses proxy associées à ce contact.

  • State (État). État du contact (pour les États-Unis).

  • StreetAddress. adresse du contact.

  • Titre. Titre du contact.

  • UserPrincipalName. ID d'utilisateur du contact.

  • ValidationStatus. indique si des erreurs sont liées au contact.