Create new navigation property to languages for 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 = @{
displayName = "Norwegian Bokmål"
tag = "nb-NO"
spoken = "nativeOrBilingual"
written = "nativeOrBilingual"
reading = "nativeOrBilingual"
}
# A UPN can also be used as -UserId.
New-MgBetaUserProfileLanguage -UserId $userId -BodyParameter $params
This example shows how to use the New-MgBetaUserProfileLanguage Cmdlet.
Parameters
-AdditionalProperties
Additional Parameters
Parameter properties
Type:
System.Collections.Hashtable
Supports wildcards:
False
DontShow:
False
Parameter sets
CreateViaIdentityExpanded
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
CreateExpanded
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
CreateViaIdentityExpanded
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
CreateExpanded
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-BodyParameter
languageProficiency
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.
Contains the four-character BCP47 name for the language (en-US, no-NB, en-AU).
Parameter properties
Type:
System.String
Supports wildcards:
False
DontShow:
False
Parameter sets
CreateViaIdentityExpanded
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
CreateExpanded
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-ThumbnailUrl
Create new navigation property to languages for 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,
Parameter properties
Type:
System.String
Supports wildcards:
False
DontShow:
False
Parameter sets
CreateViaIdentityExpanded
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
CreateExpanded
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
CreateExpanded
Position:
Named
Mandatory:
True
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
Create
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
-Written
languageProficiencyLevel
Parameter properties
Type:
System.String
Supports wildcards:
False
DontShow:
False
Parameter sets
CreateViaIdentityExpanded
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
CreateExpanded
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 <IMicrosoftGraphLanguageProficiency>: languageProficiency
[(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.
[DisplayName <String>]: Contains the long-form name for the language.
[Proficiency <String>]: languageProficiencyLevel
[Reading <String>]: languageProficiencyLevel
[Spoken <String>]: languageProficiencyLevel
[Tag <String>]: Contains the four-character BCP47 name for the language (en-US, no-NB, en-AU).
[ThumbnailUrl <String>]:
[Written <String>]: languageProficiencyLevel
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
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
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>]: