Office.UserProfile interface

Paket:
outlook

Informationen über den Benutzer, der dem Postfach zugeordnet ist. Dazu gehören der Kontotyp, der Anzeigename, die E-Mail-Adresse und die Zeitzone.

Hinweise

Mindestberechtigungsstufe: Element lesen

Anwendbarer Outlook-Modus: Compose oder Lesen

Verwendet von

Eigenschaften

accountType

Ruft den Kontotyp des Benutzers ab, der dem Postfach zugeordnet ist.
displayName

Ruft den Anzeigenamen des aktuellen Benutzers ab.
emailAddress

Ruft die SMTP-E-Mail-Adresse des Benutzers ab.
timeZone

Ruft die Zeitzone des Benutzers im Windows-Format ab.

Die Systemzeitzone wird in der Regel zurückgegeben. In Outlook im Web und im neuen Outlook unter Windows) wird jedoch stattdessen die Standardzeitzone in den Kalendereinstellungen zurückgegeben.

Details zur Eigenschaft

accountType

Ruft den Kontotyp des Benutzers ab, der dem Postfach zugeordnet ist.

accountType: string;

Eigenschaftswert

string

Hinweise

API-Satz: Postfach 1.6

Mindestberechtigungsstufe: Element lesen

Anwendbarer Outlook-Modus: Compose oder Lesen

Die möglichen Kontotypen sind in der folgenden Tabelle aufgeführt.

Wert Beschreibung
Unternehmen Das Postfach befindet sich auf einem lokalen Exchange-Server.
Gmail Das Postfach ist mit einem Gmail-Konto verknüpft.
Office365 Das Postfach ist einem Microsoft 365-Geschäfts-, Schul- oder Unikonto zugeordnet.
outlookCom Das Postfach ist einem persönlichen Outlook.com Konto zugeordnet.

Wichtig:

  • Unbefristete Volumenlizenz Outlook 2016 unterstützt diese accountType Eigenschaft nicht. Um dieses Problem zu umgehen, verwenden Sie Exchange-Webdienste (EWS), um den ResolveNames-Vorgang auf dem lokalen Exchange-Server aufzurufen.

  • In hybriden Exchange-Umgebungen hängt der zurückgegebene Kontotypwert davon ab, wo das Postfach gehostet wird. Wenn sich das Postfach auf einem lokalen Server befindet, lautet der Kontotypwert "Enterprise". Wenn das Konto jedoch in Exchange Online gehostet wird, lautet der Kontotypwert "office365".

Beispiele

console.log(Office.context.mailbox.userProfile.accountType);

displayName

Ruft den Anzeigenamen des aktuellen Benutzers ab.

displayName: string;

Eigenschaftswert

string

Hinweise

Mindestberechtigungsstufe: Element lesen

Anwendbarer Outlook-Modus: Compose oder Lesen

Beispiele

// Example: Allie Bellew
console.log(Office.context.mailbox.userProfile.displayName);

emailAddress

Ruft die SMTP-E-Mail-Adresse des Benutzers ab.

emailAddress: string;

Eigenschaftswert

string

Hinweise

Mindestberechtigungsstufe: Element lesen

Anwendbarer Outlook-Modus: Compose oder Lesen

Beispiele

// Example: allieb@contoso.com
console.log(Office.context.mailbox.userProfile.emailAddress);

timeZone

Ruft die Zeitzone des Benutzers im Windows-Format ab.

Die Systemzeitzone wird in der Regel zurückgegeben. In Outlook im Web und im neuen Outlook unter Windows) wird jedoch stattdessen die Standardzeitzone in den Kalendereinstellungen zurückgegeben.

timeZone: string;

Eigenschaftswert

string

Hinweise

Mindestberechtigungsstufe: Element lesen

Anwendbarer Outlook-Modus: Compose oder Lesen

Beispiele

// Example: Pacific Standard Time
console.log(Office.context.mailbox.userProfile.timeZone);