Update-MgBetaUserProfilePosition
Update the navigation property positions in users
Syntax
Update-MgBetaUserProfilePosition
-UserId <String>
-WorkPositionId <String>
[-ResponseHeadersVariable <String>]
[-AdditionalProperties <Hashtable>]
[-AllowedAudiences <String>]
[-Categories <String[]>]
[-Colleagues <IMicrosoftGraphRelatedPerson[]>]
[-CreatedBy <IMicrosoftGraphIdentitySet>]
[-CreatedDateTime <DateTime>]
[-Detail <IMicrosoftGraphPositionDetail>]
[-Id <String>]
[-Inference <IMicrosoftGraphInferenceData>]
[-IsCurrent]
[-IsSearchable]
[-LastModifiedBy <IMicrosoftGraphIdentitySet>]
[-LastModifiedDateTime <DateTime>]
[-Manager <IMicrosoftGraphRelatedPerson>]
[-Source <IMicrosoftGraphPersonDataSources>]
[-Sources <IMicrosoftGraphProfileSourceAnnotation[]>]
[-Headers <IDictionary>]
[-ProgressAction <ActionPreference>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Update-MgBetaUserProfilePosition
-UserId <String>
-WorkPositionId <String>
-BodyParameter <IMicrosoftGraphWorkPosition>
[-ResponseHeadersVariable <String>]
[-Headers <IDictionary>]
[-ProgressAction <ActionPreference>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Update-MgBetaUserProfilePosition
-InputObject <IPeopleIdentity>
[-ResponseHeadersVariable <String>]
[-AdditionalProperties <Hashtable>]
[-AllowedAudiences <String>]
[-Categories <String[]>]
[-Colleagues <IMicrosoftGraphRelatedPerson[]>]
[-CreatedBy <IMicrosoftGraphIdentitySet>]
[-CreatedDateTime <DateTime>]
[-Detail <IMicrosoftGraphPositionDetail>]
[-Id <String>]
[-Inference <IMicrosoftGraphInferenceData>]
[-IsCurrent]
[-IsSearchable]
[-LastModifiedBy <IMicrosoftGraphIdentitySet>]
[-LastModifiedDateTime <DateTime>]
[-Manager <IMicrosoftGraphRelatedPerson>]
[-Source <IMicrosoftGraphPersonDataSources>]
[-Sources <IMicrosoftGraphProfileSourceAnnotation[]>]
[-Headers <IDictionary>]
[-ProgressAction <ActionPreference>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Update-MgBetaUserProfilePosition
-InputObject <IPeopleIdentity>
-BodyParameter <IMicrosoftGraphWorkPosition>
[-ResponseHeadersVariable <String>]
[-Headers <IDictionary>]
[-ProgressAction <ActionPreference>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
Update the navigation property positions 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 = @{
isCurrent = $true
}
# A UPN can also be used as -UserId.
Update-MgBetaUserProfilePosition -UserId $userId -WorkPositionId $workPositionId -BodyParameter $paramsThis example shows how to use the Update-MgBetaUserProfilePosition Cmdlet.
Parameters
-AdditionalProperties
Additional Parameters
| Type: | Hashtable |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AllowedAudiences
allowedAudiences
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-BodyParameter
workPosition To construct, see NOTES section for BODYPARAMETER properties and create a hash table.
| Type: | IMicrosoftGraphWorkPosition |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Categories
Categories that the user has associated with this position.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Colleagues
Colleagues that are associated with this position. To construct, see NOTES section for COLLEAGUES properties and create a hash table.
| Type: | IMicrosoftGraphRelatedPerson[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
Prompts you for confirmation before running the cmdlet.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CreatedBy
identitySet To construct, see NOTES section for CREATEDBY properties and create a hash table.
| Type: | IMicrosoftGraphIdentitySet |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CreatedDateTime
Provides the dateTimeOffset for when the entity was created.
| Type: | DateTime |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Detail
positionDetail To construct, see NOTES section for DETAIL properties and create a hash table.
| Type: | IMicrosoftGraphPositionDetail |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Headers
Optional headers that will be added to the request.
| Type: | IDictionary |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Id
The unique identifier for an entity. Read-only.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Inference
inferenceData To construct, see NOTES section for INFERENCE properties and create a hash table.
| Type: | IMicrosoftGraphInferenceData |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InputObject
Identity Parameter To construct, see NOTES section for INPUTOBJECT properties and create a hash table.
| Type: | IPeopleIdentity |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-IsCurrent
Denotes whether or not the position is current.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-IsSearchable
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-LastModifiedBy
identitySet To construct, see NOTES section for LASTMODIFIEDBY properties and create a hash table.
| Type: | IMicrosoftGraphIdentitySet |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-LastModifiedDateTime
Provides the dateTimeOffset for when the entity was created.
| Type: | DateTime |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Manager
relatedPerson To construct, see NOTES section for MANAGER properties and create a hash table.
| Type: | IMicrosoftGraphRelatedPerson |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ProgressAction
{{ Fill ProgressAction Description }}
| Type: | ActionPreference |
| Aliases: | proga |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ResponseHeadersVariable
Optional Response Headers Variable.
| Type: | String |
| Aliases: | RHV |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Source
personDataSources To construct, see NOTES section for SOURCE properties and create a hash table.
| Type: | IMicrosoftGraphPersonDataSources |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Sources
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.
| Type: | IMicrosoftGraphProfileSourceAnnotation[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UserId
The unique identifier of user
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
Shows what would happen if the cmdlet runs. The cmdlet is not run.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WorkPositionId
The unique identifier of workPosition
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Inputs
Microsoft.Graph.Beta.PowerShell.Models.IMicrosoftGraphWorkPosition
Microsoft.Graph.Beta.PowerShell.Models.IPeopleIdentity
System.Collections.IDictionary
Outputs
Microsoft.Graph.Beta.PowerShell.Models.IMicrosoftGraphWorkPosition
Notes
COMPLEX PARAMETER PROPERTIES
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 <IMicrosoftGraphWorkPosition>: workPosition
[(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.[Categories <String-[]>]: Categories that the user has associated with this position.[Colleagues <IMicrosoftGraphRelatedPerson-[]>]: Colleagues that are associated with this position.[DisplayName <String>]: Name of the person.[Relationship <String>]: personRelationship[UserId <String>]: The user's directory object ID (Microsoft Entra ID or CID).[UserPrincipalName <String>]: Email address or reference to person within the organization.
[Detail <IMicrosoftGraphPositionDetail>]: positionDetail[(Any) <Object>]: This indicates any property can be added to this object.[Company <IMicrosoftGraphCompanyDetail>]: companyDetail[(Any) <Object>]: This indicates any property can be added to this object.[Address <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
[CompanyCode <String>]: Legal entity number of the company or its subdivision. For information on how to set the value for the companyCode, see profileSourceAnnotation.[Department <String>]: Department Name within a company.[DisplayName <String>]: Company name.[OfficeLocation <String>]: Office Location of the person referred to.[Pronunciation <String>]: Pronunciation guide for the company name.[SecondaryDepartment <String>]: Secondary Department Name within a company.[WebUrl <String>]: Link to the company home page.
[Description <String>]: A description for the position in question.[EndMonthYear <DateTime?>]: The date when the position ended.[JobTitle <String>]: The title of the position.[Layer <Int32?>]: The place where the employee is within the organizational hierarchy.[Level <String>]: The employee's experience or management level.[Role <String>]: The role the position entailed.[SecondaryJobTitle <String>]: An optional job title for the position.[SecondaryRole <String>]: An optional role for the position entailed.[StartMonthYear <DateTime?>]: The start date of the position.[Summary <String>]: The summary of the position.
[IsCurrent <Boolean?>]: Denotes whether or not the position is current.[Manager <IMicrosoftGraphRelatedPerson>]: relatedPerson
COLLEAGUES <IMicrosoftGraphRelatedPerson- []>: Colleagues that are associated with this position.
[DisplayName <String>]: Name of the person.[Relationship <String>]: personRelationship[UserId <String>]: The user's directory object ID (Microsoft Entra ID or CID).[UserPrincipalName <String>]: Email address or reference to person within the organization.
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
DETAIL <IMicrosoftGraphPositionDetail>: positionDetail
[(Any) <Object>]: This indicates any property can be added to this object.[Company <IMicrosoftGraphCompanyDetail>]: companyDetail[(Any) <Object>]: This indicates any property can be added to this object.[Address <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
[CompanyCode <String>]: Legal entity number of the company or its subdivision. For information on how to set the value for the companyCode, see profileSourceAnnotation.[Department <String>]: Department Name within a company.[DisplayName <String>]: Company name.[OfficeLocation <String>]: Office Location of the person referred to.[Pronunciation <String>]: Pronunciation guide for the company name.[SecondaryDepartment <String>]: Secondary Department Name within a company.[WebUrl <String>]: Link to the company home page.
[Description <String>]: A description for the position in question.[EndMonthYear <DateTime?>]: The date when the position ended.[JobTitle <String>]: The title of the position.[Layer <Int32?>]: The place where the employee is within the organizational hierarchy.[Level <String>]: The employee's experience or management level.[Role <String>]: The role the position entailed.[SecondaryJobTitle <String>]: An optional job title for the position.[SecondaryRole <String>]: An optional role for the position entailed.[StartMonthYear <DateTime?>]: The start date of the position.[Summary <String>]: The summary of the position.
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
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
MANAGER <IMicrosoftGraphRelatedPerson>: relatedPerson
[(Any) <Object>]: This indicates any property can be added to this object.[DisplayName <String>]: Name of the person.[Relationship <String>]: personRelationship[UserId <String>]: The user's directory object ID (Microsoft Entra ID or CID).[UserPrincipalName <String>]: Email address or reference to person within the organization.
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>]: