Freigeben über

Get-MsolContact

  • Referenz
Modul:
MSOnline

Ruft Kontakte aus Azure Active Directory ab.

Syntax

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

Beschreibung

Das Cmdlet Get-MsolContact ruft ein Kontaktobjekt oder eine Kontaktliste ab. Geben Sie den ObjectId-Parameter an, um einen einzelnen Kontakt abzurufen.

Beispiele

Beispiel 1: Abrufen eines Kontakts

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

Mit diesem Befehl wird ein Kontakt abgerufen.

Beispiel 2: Abrufen von Kontakten, die einer Zeichenfolge entsprechen

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

Dieser Befehl ruft eine Liste von Kontakten mit einem Anzeigenamen oder einer E-Mail-Adresse ab Patti ab.

Parameter

-All

Gibt an, dass dieses Cmdlet alle gefundenen Ergebnisse zurückgibt. Geben Sie diesen Parameter und den MaxResults-Parameter nicht an.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-HasErrorsOnly

Gibt an, dass dieses Cmdlet Kontakte zurückgibt, die Überprüfungsfehler aufweisen.

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-MaxResults

Gibt die maximale Anzahl von Ergebnissen an, die dieses Cmdlet zurückgibt. Der Standardwert ist 500.

Typ:Int32
Position:Named
Standardwert:500
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ObjectId

Gibt die eindeutige Objekt-ID des abzurufenden Kontakts an.

Typ:Guid
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-SearchString

Gibt eine Zeichenfolge an. Dieses Cmdlet gibt Kontakte mit einem Anzeigenamen oder einer E-Mail-Adresse zurück, die mit dieser Zeichenfolge beginnen.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-TenantId

Gibt die eindeutige ID des Mandanten an, für den der Vorgang ausgeführt werden soll. Der Standardwert ist der Mandant des aktuellen Benutzers. Dieser Parameter gilt nur für Partnerbenutzer.

Typ:Guid
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

Ausgaben

Microsoft.Online.Administration.Contact

Dieses Cmdlet gibt Kontaktobjekte zurück, die die folgenden Informationen enthalten:

  • City. Die Stadt des Kontakts.

  • Land/Region. Das Land oder die Region des Kontakts.

  • Abteilung. Die Abteilung des Kontakts.

  • DisplayName. Der Anzeigename des Kontakts.

  • Fax. Die Faxnummer des Kontakts.

  • Firstname. Der Vorname des Kontakts.

  • LastDirSyncTime. Gibt das Datum und die Uhrzeit der letzten Synchronisierung zurück (wird nur von Kontakten zurückgegeben, die mit der Active Directory-Synchronisierung synchronisiert werden).

  • LastName. Der Nachname des Kontakts.

  • Handy. Die Mobiltelefonnummer des Kontakts.

  • Objectid. Die eindeutige ID des Kontakts.

  • Büro. Die geschäftliche Telefonnummer des Kontakts.

  • Telefonnummer. Die Telefonnummer des Kontakts.

  • Plz. Die Postleitzahl des Kontakts.

  • Proxyadressen. Die Proxyadressen, die diesem Kontakt zugeordnet sind.

  • Status. Das Bundesland des Kontakts.

  • StreetAddress. Die Straße des Kontakts.

  • Titel. Der Titel des Kontakts.

  • Userprincipalname. Die Benutzer-ID des Kontakts.

  • Ein ValidationStatus. Gibt an, ob für den Kontakt Fehler aufgetreten sind.