Skip to content

personname.md

Latest commit

 

History

History
100 lines (90 loc) · 4.66 KB

personname.md

File metadata and controls

100 lines (90 loc) · 4.66 KB
title personName resource type
description personName resource type
ms.localizationpriority medium
author kevinbellinger
ms.subservice people
doc_type resourcePageType
ms.date 07/22/2024

personName resource type

Namespace: microsoft.graph

[!INCLUDE beta-disclaimer]

Represents extended name information provided by the user or which they have associated within their profile.

Inherits from itemFacet.

Methods

Method Return type Description
List personName collection Get the personName resources from the names navigation property.
Create personName Create a new personName object from the names navigation property.
Get personName Read the properties and relationships of a personName object.
Update personName Update the properties of a personName object.
Delete None Deletes a personName object.

Properties

Property Type Description
allowedAudiences String The audiences that are able to see the values contained within the entity. Inherited from itemFacet. The possible values are: me, family, contacts, groupMembers, organization, federatedOrganizations, everyone, unknownFutureValue.
createdBy identitySet Provides the identifier of the user and/or application that created the entity. Inherited from itemFacet.
createdDateTime DateTimeOffset Provides the dateTimeOffset for when the entity was created. Inherited from itemFacet.
displayName String Provides an ordered rendering of firstName and lastName depending on the locale of the user or their device.
first String First name of the user.
id String Identifier used for individually addressing the entity. Inherited from entity
inference inferenceData Contains inference detail if the entity is inferred by the creating or modifying application. Inherited from itemFacet.
initials String Initials of the user.
languageTag String Contains the name for the language (en-US, no-NB, en-AU) following IETF BCP47 format.
last String Last name of the user.
lastModifiedBy identitySet Provides the identifier of the user and/or application that last modified the entity. Inherited from itemFacet.
lastModifiedDateTime DateTimeOffset Provides the dateTimeOffset for when the entity was created. Inherited from itemFacet.
maiden String Maiden name of the user.
middle String Middle name of the user.
nickname String Nickname of the user.
pronunciation yomiPersonName Guidance on how to pronounce the users name.
source personDataSource Where the values originated if synced from another service. Inherited from itemFacet.
suffix String Designators used after the users name (eg: PhD.)
title String Honorifics used to prefix a users name (eg: Dr, Sir, Madam, Mrs.)

Relationships

None.

JSON representation

The following JSON representation shows the resource type.

{
  "@odata.type": "#microsoft.graph.personName",
  "id": "e13f7a4d-303c-464f-a6af-80ea18eb74f3",
  "allowedAudiences": "organization",
  "inference": {
    "@odata.type": "microsoft.graph.inferenceData"
  },
  "createdDateTime": "2020-07-06T06:34:12.2294868Z",
  "createdBy": {
    "@odata.type": "microsoft.graph.identitySet"
  },
  "lastModifiedDateTime": "2020-07-06T06:34:12.2294868Z",
  "lastModifiedBy": {
    "@odata.type": "microsoft.graph.identitySet"
  },
  "source": {
    "@odata.type": "microsoft.graph.personDataSource"
  },
  "displayName": "Innocenty Popov",
  "first": "Innocenty",
  "initials": "IP",
  "last": "Popov",
  "languageTag": "en-US",
  "maiden": null,
  "middle": null,
  "nickname": "Kesha",
  "suffix": null,
  "title": null,
  "pronunciation": {
    "@odata.type": "microsoft.graph.yomiPersonName"
  }
}