Compartir a través de

Get-MsolContact

  • Referencia
Módulo:
MSOnline

Obtiene contactos de Azure Active Directory.

Sintaxis

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

El cmdlet Get-MsolContact obtiene un objeto de contacto o una lista de contactos. Especifique el parámetro ObjectId para obtener un único contacto.

Ejemplos

Ejemplo 1: Obtener un contacto

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

Este comando recupera un contacto.

Ejemplo 2: Obtener contactos que coinciden con una cadena

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

Este comando recupera una lista de contactos con un nombre para mostrar o una dirección de correo electrónico a partir de Patti.

Parámetros

-All

Indica que este cmdlet devuelve todos los resultados que encuentra. No especifique este parámetro y el parámetro MaxResults .

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-HasErrorsOnly

Indica que este cmdlet devuelve contactos que tienen errores de validación.

Tipo:Boolean
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-MaxResults

Especifica el número máximo de resultados que devuelve este cmdlet. El valor predeterminado es 500.

Tipo:Int32
Posición:Named
Valor predeterminado:500
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ObjectId

Especifica el identificador de objeto único del contacto que se va a obtener.

Tipo:Guid
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-SearchString

Especifica una cadena. Este cmdlet devuelve contactos con un nombre para mostrar o una dirección de correo electrónico que comienzan con esta cadena.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-TenantId

Especifica el identificador único del inquilino en el que se va a realizar la operación. El valor predeterminado es el inquilino del usuario actual. Este parámetro solo se aplica a los usuarios asociados.

Tipo:Guid
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

Salidas

Microsoft.Online.Administration.Contact

Este cmdlet devuelve objetos de contacto, que incluyen la siguiente información:

  • Ciudad. La ciudad del contacto.

  • País. País o región del contacto.

  • Departamento. Departamento del contacto.

  • DisplayName. Nombre para mostrar del contacto.

  • Fax. Número de fax del contacto

  • Apellido. Nombre del contacto.

  • LastDirSyncTime. Devuelve la fecha y la hora de la última sincronización (solo se devuelve desde contactos sincronizados con la sincronización de Active Directory).

  • LastName. Apellido del contacto.

  • Móvil. Número de teléfono móvil del contacto.

  • Idobjeto. El identificador único del contacto.

  • Oficina. El número de oficina del contacto.

  • Número de teléfono. Número telefónico del contacto.

  • Código postal. Código postal del contacto.

  • Direcciones de proxy. Direcciones de proxy asociadas a este contacto.

  • State El estado del contacto.

  • StreetAddress. Dirección del contacto.

  • Título. Título del contacto.

  • Userprincipalname. El identificador de usuario del contacto.

  • ValidationStatus. Indica si el contacto tiene errores o no.