Update the navigation property educationalActivities in users
Permissions
Permission type
Permissions (from least to most privileged)
Delegated (work or school account)
User.ReadWrite, User.ReadWrite.All,
Delegated (personal Microsoft account)
User.ReadWrite,
Application
User.ReadWrite.All,
Examples
Example 1: Code snippet
Import-Module Microsoft.Graph.Beta.People
$params = @{
institution = @{
location = @{
type = "business"
postOfficeBox = $null
street = "12000 E Prospect Rd"
city = "Fort Collins"
state = "Colorado"
countryOrRegion = "USA"
postalCode = "80525"
}
}
}
# A UPN can also be used as -UserId.
Update-MgBetaUserProfileEducationalActivity -UserId $userId -EducationalActivityId $educationalActivityId -BodyParameter $params
This example shows how to use the Update-MgBetaUserProfileEducationalActivity Cmdlet.
Parameters
-AdditionalProperties
Additional Parameters
Parameter properties
Type:
System.Collections.Hashtable
Supports wildcards:
False
DontShow:
False
Parameter sets
UpdateViaIdentityExpanded
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
UpdateExpanded
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-AllowedAudiences
allowedAudiences
Parameter properties
Type:
System.String
Supports wildcards:
False
DontShow:
False
Parameter sets
UpdateViaIdentityExpanded
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
UpdateExpanded
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-BodyParameter
educationalActivity
To construct, see NOTES section for BODYPARAMETER properties and create a hash table.
Where the values within an entity originated if synced from another source.
To construct, see NOTES section for SOURCES properties and create a hash table.
The month and year the user commenced the activity referenced.
Parameter properties
Type:
System.DateTime
Supports wildcards:
False
DontShow:
False
Parameter sets
UpdateViaIdentityExpanded
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
UpdateExpanded
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-UserId
The unique identifier of user
Parameter properties
Type:
System.String
Supports wildcards:
False
DontShow:
False
Parameter sets
UpdateExpanded
Position:
Named
Mandatory:
True
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
Update
Position:
Named
Mandatory:
True
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-WhatIf
Runs the command in a mode that only reports what would happen without performing the actions.
Parameter properties
Type:
System.Management.Automation.SwitchParameter
Supports wildcards:
False
DontShow:
False
Aliases:
wi
Parameter sets
(All)
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable,
-InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable,
-ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see
about_CommonParameters.
To create the parameters described below, construct a hash table containing the appropriate properties.
For information on hash tables, run Get-Help about_Hash_Tables.
BODYPARAMETER <IMicrosoftGraphEducationalActivity>: educationalActivity
[(Any) <Object>]: This indicates any property can be added to this object.
[AllowedAudiences <String>]: allowedAudiences
[CreatedBy <IMicrosoftGraphIdentitySet>]: identitySet
[(Any) <Object>]: This indicates any property can be added to this object.
[Application <IMicrosoftGraphIdentity>]: identity
[(Any) <Object>]: This indicates any property can be added to this object.
[DisplayName <String>]: The display name of the identity.
This property is read-only.
[Id <String>]: The identifier of the identity.
This property is read-only.
[Device <IMicrosoftGraphIdentity>]: identity
[User <IMicrosoftGraphIdentity>]: identity
[CreatedDateTime <DateTime?>]: Provides the dateTimeOffset for when the entity was created.
[Inference <IMicrosoftGraphInferenceData>]: inferenceData
[(Any) <Object>]: This indicates any property can be added to this object.
[ConfidenceScore <Double?>]: Confidence score reflecting the accuracy of the data inferred about the user.
[UserHasVerifiedAccuracy <Boolean?>]: Records if the user has confirmed this inference as being True or False.
[IsSearchable <Boolean?>]:
[LastModifiedBy <IMicrosoftGraphIdentitySet>]: identitySet
[LastModifiedDateTime <DateTime?>]: Provides the dateTimeOffset for when the entity was created.
[Source <IMicrosoftGraphPersonDataSources>]: personDataSources
[(Any) <Object>]: This indicates any property can be added to this object.
[Type <String[]>]:
[Sources <IMicrosoftGraphProfileSourceAnnotation[]>]: Where the values within an entity originated if synced from another source.
[IsDefaultSource <Boolean?>]: Indicates whether the source is the default one.
[Properties <String[]>]: Names of properties that have data from this source.
[SourceId <String>]:
[Id <String>]: The unique identifier for an entity.
Read-only.
[CompletionMonthYear <DateTime?>]: The month and year the user graduated or completed the activity.
[EndMonthYear <DateTime?>]: The month and year the user completed the educational activity referenced.
[Institution <IMicrosoftGraphInstitutionData>]: institutionData
[(Any) <Object>]: This indicates any property can be added to this object.
[Description <String>]: Short description of the institution the user studied at.
[DisplayName <String>]: Name of the institution the user studied at.
[Location <IMicrosoftGraphPhysicalAddress>]: physicalAddress
[(Any) <Object>]: This indicates any property can be added to this object.
[City <String>]: The city.
[CountryOrRegion <String>]: The country or region.
It's a free-format string value, for example, 'United States'.
[PostOfficeBox <String>]: The post office box number.
[PostalCode <String>]: The postal code.
[State <String>]: The state.
[Street <String>]: The street.
[Type <String>]: physicalAddressType
[WebUrl <String>]: Link to the institution or department homepage.
[Program <IMicrosoftGraphEducationalActivityDetail>]: educationalActivityDetail
[(Any) <Object>]: This indicates any property can be added to this object.
[Abbreviation <String>]: Shortened name of the degree or program (example: PhD, MBA)
[Activities <String[]>]: Extracurricular activities undertaken alongside the program.
[Awards <String[]>]: Any awards or honors associated with the program.
[Description <String>]: Short description of the program provided by the user.
[DisplayName <String>]: Long-form name of the program that the user provided.
[FieldsOfStudy <String[]>]: Majors and minors associated with the program.
(if applicable)
[Grade <String>]: The final grade, class, GPA, or score.
[Notes <String>]: More notes the user provided.
[WebUrl <String>]: Link to the degree or program page.
[StartMonthYear <DateTime?>]: The month and year the user commenced the activity referenced.
CREATEDBY <IMicrosoftGraphIdentitySet>: identitySet
[(Any) <Object>]: This indicates any property can be added to this object.
[Application <IMicrosoftGraphIdentity>]: identity
[(Any) <Object>]: This indicates any property can be added to this object.
[DisplayName <String>]: The display name of the identity.
This property is read-only.
[Id <String>]: The identifier of the identity.
This property is read-only.
[Device <IMicrosoftGraphIdentity>]: identity
[User <IMicrosoftGraphIdentity>]: identity
INFERENCE <IMicrosoftGraphInferenceData>: inferenceData
[(Any) <Object>]: This indicates any property can be added to this object.
[ConfidenceScore <Double?>]: Confidence score reflecting the accuracy of the data inferred about the user.
[UserHasVerifiedAccuracy <Boolean?>]: Records if the user has confirmed this inference as being True or False.
INPUTOBJECT <IPeopleIdentity>: Identity Parameter
[ActivityStatisticsId <String>]: The unique identifier of activityStatistics
[EducationalActivityId <String>]: The unique identifier of educationalActivity
[ItemAddressId <String>]: The unique identifier of itemAddress
[ItemEmailId <String>]: The unique identifier of itemEmail
[ItemPatentId <String>]: The unique identifier of itemPatent
[ItemPhoneId <String>]: The unique identifier of itemPhone
[ItemPublicationId <String>]: The unique identifier of itemPublication
[LanguageProficiencyId <String>]: The unique identifier of languageProficiency
[PersonAnnotationId <String>]: The unique identifier of personAnnotation
[PersonAnnualEventId <String>]: The unique identifier of personAnnualEvent
[PersonAwardId <String>]: The unique identifier of personAward
[PersonCertificationId <String>]: The unique identifier of personCertification
[PersonId <String>]: The unique identifier of person
[PersonInterestId <String>]: The unique identifier of personInterest
[PersonNameId <String>]: The unique identifier of personName
[PersonWebsiteId <String>]: The unique identifier of personWebsite
[ProjectParticipationId <String>]: The unique identifier of projectParticipation
[SkillProficiencyId <String>]: The unique identifier of skillProficiency
[UserAccountInformationId <String>]: The unique identifier of userAccountInformation
[UserId <String>]: The unique identifier of user
[WebAccountId <String>]: The unique identifier of webAccount
[WorkPositionId <String>]: The unique identifier of workPosition
INSTITUTION <IMicrosoftGraphInstitutionData>: institutionData
[(Any) <Object>]: This indicates any property can be added to this object.
[Description <String>]: Short description of the institution the user studied at.
[DisplayName <String>]: Name of the institution the user studied at.
[Location <IMicrosoftGraphPhysicalAddress>]: physicalAddress
[(Any) <Object>]: This indicates any property can be added to this object.
[City <String>]: The city.
[CountryOrRegion <String>]: The country or region.
It's a free-format string value, for example, 'United States'.
[PostOfficeBox <String>]: The post office box number.
[PostalCode <String>]: The postal code.
[State <String>]: The state.
[Street <String>]: The street.
[Type <String>]: physicalAddressType
[WebUrl <String>]: Link to the institution or department homepage.
LASTMODIFIEDBY <IMicrosoftGraphIdentitySet>: identitySet
[(Any) <Object>]: This indicates any property can be added to this object.
[Application <IMicrosoftGraphIdentity>]: identity
[(Any) <Object>]: This indicates any property can be added to this object.
[DisplayName <String>]: The display name of the identity.
This property is read-only.
[Id <String>]: The identifier of the identity.
This property is read-only.
[Device <IMicrosoftGraphIdentity>]: identity
[User <IMicrosoftGraphIdentity>]: identity
PROGRAM <IMicrosoftGraphEducationalActivityDetail>: educationalActivityDetail
[(Any) <Object>]: This indicates any property can be added to this object.
[Abbreviation <String>]: Shortened name of the degree or program (example: PhD, MBA)
[Activities <String[]>]: Extracurricular activities undertaken alongside the program.
[Awards <String[]>]: Any awards or honors associated with the program.
[Description <String>]: Short description of the program provided by the user.
[DisplayName <String>]: Long-form name of the program that the user provided.
[FieldsOfStudy <String[]>]: Majors and minors associated with the program.
(if applicable)
[Grade <String>]: The final grade, class, GPA, or score.
[Notes <String>]: More notes the user provided.
[WebUrl <String>]: Link to the degree or program page.
SOURCE <IMicrosoftGraphPersonDataSources>: personDataSources
[(Any) <Object>]: This indicates any property can be added to this object.
[Type <String[]>]:
SOURCES <IMicrosoftGraphProfileSourceAnnotation[]>: Where the values within an entity originated if synced from another source.
[IsDefaultSource <Boolean?>]: Indicates whether the source is the default one.
[Properties <String[]>]: Names of properties that have data from this source.
[SourceId <String>]: