Get-MsolContact

  • Riferimento
Modulo:
MSOnline

Ottiene i contatti da Azure Active Directory.

Sintassi

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>]

Descrizione

Il cmdlet Get-MsolContact ottiene un oggetto contatto o un elenco di contatti. Specificare il parametro ObjectId per ottenere un singolo contatto.

Esempio

Esempio 1: Ottenere un contatto

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

Questo comando recupera un contatto.

Esempio 2: Ottenere contatti che corrispondono a una stringa

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

Questo comando recupera un elenco di contatti con un nome visualizzato o un indirizzo di posta elettronica a partire da Patti.

Parametri

-All

Indica che questo cmdlet restituisce tutti i risultati trovati. Non specificare questo parametro e il parametro MaxResults .

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-HasErrorsOnly

Indica che questo cmdlet restituisce i contatti con errori di convalida.

Tipo:Boolean
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-MaxResults

Specifica il numero massimo di risultati restituiti dal cmdlet. Il valore predefinito è 500.

Tipo:Int32
Posizione:Named
Valore predefinito:500
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ObjectId

Specifica l'ID oggetto univoco del contatto da ottenere.

Tipo:Guid
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-SearchString

Specifica una stringa. Questo cmdlet restituisce i contatti con un nome visualizzato o un indirizzo di posta elettronica che iniziano con questa stringa.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-TenantId

Specifica l'ID univoco del tenant in cui eseguire l'operazione. Il valore predefinito è il tenant dell'utente corrente. Questo parametro si applica solo agli utenti partner.

Tipo:Guid
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

Output

Microsoft.Online.Administration.Contact

Questo cmdlet restituisce oggetti contatto, che includono le informazioni seguenti:

  • City. la città del contatto.

  • Paese. Paese o area geografica del contatto.

  • Dipartimento. Il reparto del contatto.

  • Displayname. Il nome visualizzato del contatto.

  • Fax. il numero di fax del contatto.

  • Firstname. Nome del contatto.

  • LastDirSyncTime. restituisce la data e l'ora dell'ultima sincronizzazione (solo dai contatti sincronizzati con la sincronizzazione di Active Directory).

  • LastName Cognome del contatto.

  • Mobilephone. Il numero di cellulare del contatto.

  • Objectid. l'ID univoco del contatto.

  • Ufficio. il numero dell'ufficio del contatto.

  • Numero di telefono. Numero di telefono del contatto.

  • Codice postale. il codice postale del contatto.

  • Indirizzi proxy. Gli indirizzi proxy associati a questo contatto.

  • Stato. lo stato del contatto.

  • StreetAddress. l'indirizzo del contatto.

  • Titolo. Il titolo del contatto.

  • Userprincipalname. l'ID utente del contatto.

  • ValidationStatus. l'indicazione dell'eventuale presenza di errori associati al contatto.