user-Ressourcentyp

Namespace: microsoft.graph

Stellt ein Microsoft Entra-Benutzerkonto dar. Diese Ressource ist ein offener Typ, der über die hier dokumentierten hinaus zusätzliche Eigenschaften zulässt. Erbt von directoryObject.

Aus Leistungsgründen geben die Vorgänge create, get und list standardmäßig nur eine Teilmenge häufig verwendeter Eigenschaften zurück. Diese Standardeigenschaften werden im Abschnitt Eigenschaften aufgeführt. Um bestimmte Eigenschaften abzurufen, die standardmäßig nicht zurückgegeben werden, geben Sie sie in einer $select OData-Abfrageoption an.

Diese Ressource unterstützt Folgendes:

• Hinzufügen Ihrer Daten zu benutzerdefinierten Eigenschaften als Erweiterungen.
• Abonnieren von Änderungsbenachrichtigungen.
• Verwenden einer Delta-Abfrage zum Nachverfolgen von inkrementellen Hinzufügungen, Löschungen und Aktualisierungen durch Bereitstellen der delta-Funktion.

Die agentUser-Ressource erbt von dieser Ressource.

Methoden

Eigenschaften

mail- und proxyAddresses-Eigenschaften

mail und proxyAddresses sind beide E-Mail-bezogene Eigenschaften. proxyAddresses ist eine Sammlung von Adressen, die nur für den Microsoft Exchange Server relevant sind. Sie wird verwendet, um eine Liste von E-Mail-Adressen für einen Benutzer zu speichern, die an ein einzelnes Postfach gebunden sind. Die mail-Eigenschaft wird als E-Mail-Adresse des Benutzers für verschiedene Zwecke verwendet, einschließlich der Benutzeranmeldung, und definiert die primäre Proxyadresse.

mail- und proxyAddresses können über die GET-Benutzer-API abgerufen werden. Sie können die E-Mailüber die Benutzeraktualisierungs-API aktualisieren, aber Sie können proxyAddresses nicht über Microsoft Graph aktualisieren. Wenn die mail-Eigenschaft eines Benutzers aktualisiert wird, wird eine Neuberechnung von proxyAddresses ausgelöst, und die neu aktualisierte E-Mail wird als primäre Proxyadresse festgelegt, außer in den folgenden Szenarien:

1. Wenn ein Benutzer über eine Lizenz verfügt, die Microsoft Exchange enthält, müssen alle seine Proxyadressen zu einer verifizierten Domäne des Mandanten gehören. Alle, die nicht zu verifizierten Domänen gehören, werden im Hintergrund entfernt.
2. Die E-Mail eines Benutzers wird NICHT auf die primäre Proxyadresse festgelegt, wenn der Benutzer ein Gast ist und die primäre Proxyadresse die UPN-Zeichenfolge des Gastbenutzers mit #EXT#enthält.
3. Die E-Mail eines Benutzers wird NICHT entfernt, auch wenn er keine Proxyadressen mehr hat, wenn der Benutzer ein Gast ist.

proxyAddresses sind für alle Verzeichnisobjekte (Benutzer, Gruppen und Organisationskontakte) eindeutig. Wenn die mail-Eigenschaft eines Benutzers mit einer der proxyAddresses eines anderen Objekts in Konflikt steht, schlägt ein Versuch, die E-Mail zu aktualisieren, fehl, und die proxyAddresses-Eigenschaft wird ebenfalls nicht aktualisiert.

Benutzereinstellungen für Sprachen und regionale Formate

Die Benutzerressource enthält eine mailboxSettings-Eigenschaft , die die bevorzugte Sprache, die Datums- und Uhrzeitformatierung, die Standardzeitzone und weitere Einstellungen speziell für das primäre Exchange-Postfach enthält. Diese Einstellungen richten sich an E-Mail-Clients und sind nur verfügbar, wenn dem Benutzer ein Postfach bereitgestellt wurde. Sie können "mailboxSettings " verwenden, wenn sich Ihr Szenario nur auf Outlook-E-Mail, -Kalender, -Kontakte oder -Aufgaben konzentriert.

Zusätzlich zu mailboxSettings enthält Benutzer eine Beziehung über userSettings mit regionalAndLanguageSettings, das übergeordnete Element der Sprach- und Regionsformatierungseinstellungen, das von einer beliebigen Anwendung verwendet werden kann, um dem Benutzer die beste Sprach- und Regionsformatierungserfahrung zur Verfügung zu stellen. Verwenden Sie userSettings für eine konsistente Erfahrung in allen Apps, die das Microsoft Entra-Benutzerprofil nutzen, um dieselben Benutzereinstellungen widerzuspiegeln.

Eigenschaftsdefinitionen für gesetzliche Altersgruppen

In diesem Abschnitt wird erläutert, wie die drei Altersgruppeneigenschaften (legalAgeGroupClassification, ageGroup und consentProvidedForMinor) von Microsoft Entra-Administratoren und Unternehmensanwendungsentwicklern verwendet werden, um altersbezogene Vorschriften zu erfüllen:

• Die Eigenschaft legalAgeGroupClassification ist schreibgeschützt. Entwickler von Unternehmensanwendungen verwenden es, um die korrekte Behandlung eines Benutzers basierend auf seiner gesetzlichen Altersgruppe sicherzustellen. Sie wird basierend auf den Eigenschaften ageGroup und consentProvidedForMinor des Benutzers berechnet.
• ageGroup und consentProvidedForMinor sind optionale Eigenschaften, die von Microsoft Enttra-Administratoren verwendet werden, um sicherzustellen, dass die Verwendung eines Kontos basierend auf den altersbedingten gesetzlichen Vorschriften für das Land oder die Region des Benutzers ordnungsgemäß gehandhabt wird.

Beispiel: Cameron ist Administrator eines Verzeichnisses für eine Grundschule in Holyport im Vereinigten Königreich. Zu Beginn des Schuljahres verwendet er die Zulassungsunterlagen, um die Zustimmung der Eltern des Minderjährigen auf der Grundlage der altersbedingten Vorschriften des Vereinigten Königreichs einzuholen. Die von den Eltern eingeholte Zustimmung erlaubt, dass das Konto des Minderjährigen von Holyport School und Microsoft-Apps verwendet wird. Cameron erstellt alle Konten, legt ageGroup auf "minor" und consentProvidedForMinor auf "granted" fest. Anwendungen, die von seinen Schülern verwendet werden, sind dann in der Lage, Funktionen zu unterdrücken, die für Minderjährige nicht geeignet sind.

legalAgeGroupClassification-Werte

ageGroup-Werte

consentProvidedForMinor-Werte

Beziehungen

JSON-Darstellung

Die folgende JSON-Darstellung veranschaulicht den Ressourcentyp.

{
  "aboutMe": "String",
  "accountEnabled": "Boolean",
  "ageGroup": "String",
  "assignedLicenses": [{"@odata.type": "microsoft.graph.assignedLicense"}],
  "assignedPlans": [{"@odata.type": "microsoft.graph.assignedPlan"}],
  "authorizationInfo": {
    "@odata.type": "microsoft.graph.authorizationInfo"
  },
  "birthday": "String (timestamp)",
  "businessPhones": ["String"],
  "city": "String",
  "cloudLicensing": { "@odata.type": "microsoft.graph.cloudLicensing.userCloudLicensing" },
  "cloudRealtimeCommunicationInfo": {
    "@odata.type": "microsoft.graph.cloudRealtimeCommunicationInfo"
  },
  "companyName": "String",
  "consentProvidedForMinor": "String",
  "country": "String",
  "createdDateTime": "2019-02-07T21:53:13.067Z",
  "creationType": "String",
  "customSecurityAttributes": {
    "@odata.type": "microsoft.graph.customSecurityAttributeValue"
  },
  "deletedDateTime": "String (timestamp)",
  "department": "String",
  "displayName": "String",
  "employeeHireDate": "2020-01-01T00:00:00Z",
  "employeeId": "String",
  "employeeLeaveDateTime": "String (timestamp)",
  "employeeOrgData": {"@odata.type": "microsoft.graph.employeeOrgData"},
  "employeeType": "String",
  "externalUserConvertedOn": "String (timestamp)",
  "externalUserState": "PendingAcceptance",
  "externalUserStateChangeDateTime": "2018-11-12T01:13:13Z",
  "faxNumber": "String",
  "givenName": "String",
  "hireDate": "String (timestamp)",
  "id": "String (identifier)",
  "identities": [{"@odata.type": "microsoft.graph.objectIdentity"}],
  "identityGovernance": {"@odata.type": "microsoft.graph.identityGovernanceUserSettings"},
  "identityParentId": "String",
  "interests": ["String"],
  "isLicenseReconciliationNeeded": "Boolean",
  "isManagementRestricted": "Boolean",
  "isResourceAccount": "Boolean",
  "jobTitle": "String",
  "legalAgeGroupClassification": "String",
  "licenseAssignmentStates": [{"@odata.type": "microsoft.graph.licenseAssignmentState"}],
  "mail": "String",
  "mailboxSettings": {"@odata.type": "microsoft.graph.mailboxSettings"},
  "mailNickname": "String",
  "mobilePhone": "String",
  "mySite": "String",
  "officeLocation": "String",
  "onPremisesDistinguishedName": "String",
  "onPremisesDomainName": "String",
  "onPremisesExtensionAttributes": {"@odata.type": "microsoft.graph.onPremisesExtensionAttributes"},
  "onPremisesImmutableId": "String",
  "onPremisesLastSyncDateTime": "String (timestamp)",
  "onPremisesProvisioningErrors": [{"@odata.type": "microsoft.graph.onPremisesProvisioningError"}],
  "onPremisesSamAccountName": "String",
  "onPremisesSecurityIdentifier": "String",
  "onPremisesSipInfo": {
    "@odata.type": "microsoft.graph.onPremisesSipInfo"
  },
  "onPremisesSyncEnabled": true,
  "onPremisesUserPrincipalName": "String",
  "otherMails": ["String"],
  "passwordPolicies": "String",
  "passwordProfile": {"@odata.type": "microsoft.graph.passwordProfile"},
  "pastProjects": ["String"],
  "postalCode": "String",
  "preferredDataLocation": "String",
  "preferredLanguage": "String",
  "preferredName": "String",
  "provisionedPlans": [{"@odata.type": "microsoft.graph.provisionedPlan"}],
  "proxyAddresses": ["String"],
  "refreshTokensValidFromDateTime": "2019-02-07T21:53:13.084Z",
  "responsibilities": ["String"],
  "schools": ["String"],
  "securityIdentifier": "String",
  "serviceProvisioningErrors": [{"@odata.type": "microsoft.graph.serviceProvisioningXmlError"}],
  "showInAddressList": true,
  "signInSessionsValidFromDateTime": "2019-02-07T21:53:13.084Z",
  "skills": ["String"],
  "state": "String",
  "streetAddress": "String",
  "surname": "String",
  "usageLocation": "String",
  "userPrincipalName": "String",
  "userType": "String",
  "calendar": {"@odata.type": "microsoft.graph.calendar"},
  "calendarGroups": [{"@odata.type": "microsoft.graph.calendarGroup"}],
  "calendarView": [{"@odata.type": "microsoft.graph.event"}],
  "calendars": [{"@odata.type": "microsoft.graph.calendar"}],
  "contacts": [{"@odata.type": "microsoft.graph.contact"}],
  "contactFolders": [{"@odata.type": "microsoft.graph.contactFolder"}],
  "createdObjects": [{"@odata.type": "microsoft.graph.directoryObject"}],
  "directReports": [{"@odata.type": "microsoft.graph.directoryObject"}],
  "drive": {"@odata.type": "microsoft.graph.drive"},
  "drives": [{"@odata.type": "microsoft.graph.drive"}],
  "employeeExperience": {"@odata.type": "microsoft.graph.employeeExperienceUser"},
  "insights": {"@odata.type": "microsoft.graph.itemInsights"},
  "settings": {"@odata.type": "microsoft.graph.userSettings"},
  "events": [{"@odata.type": "microsoft.graph.event"}],
  "extensions": [{"@odata.type": "microsoft.graph.extension"}],
  "inferenceClassification": {"@odata.type": "microsoft.graph.inferenceClassification"},
  "mailFolders": [{"@odata.type": "microsoft.graph.mailFolder"}],
  "manager": {"@odata.type": "microsoft.graph.directoryObject"},
  "memberOf": [{"@odata.type": "microsoft.graph.directoryObject"}],
  "joinedTeams": [{"@odata.type": "microsoft.graph.group"}],
  "teamwork": {"@odata.type": "microsoft.graph.teamwork"},
  "messages": [{ "@odata.type": "microsoft.graph.message"}],
  "outlook": {"@odata.type": "microsoft.graph.outlookUser"},
  "ownedDevices": [{"@odata.type": "microsoft.graph.directoryObject"}],
  "photo": {"@odata.type": "microsoft.graph.profilePhoto"},
  "photos": [{ "@odata.type": "microsoft.graph.profilePhoto" }],
  "profile": {"@odata.type": "microsoft.graph.profile"},
  "registeredDevices": [{"@odata.type": "microsoft.graph.directoryObject"}],
  "signInActivity": {"@odata.type": "microsoft.graph.signInActivity"}
}

Verwandte Inhalte

• Hinzufügen von benutzerdefinierten Daten zu Ressourcen mithilfe von Erweiterungen
• Hinzufügen von benutzerdefinierten Daten zu Benutzern mithilfe offener Erweiterungen
• Hinzufügen von benutzerdefinierten Daten zu Gruppen mithilfe von Schemaerweiterungen