external help file: Microsoft.Graph.Beta.People-help.xml Module Name: Microsoft.Graph.Beta.People online version: https://learn.microsoft.com/powershell/module/microsoft.graph.beta.people/new-mgbetauserprofileskill schema: 2.0.0 ms.subservice: non-product-specific-people
New-MgBetaUserProfileSkill
SYNOPSIS
Use this API to create a new skillProficiency object in a user's profile.
SYNTAX
CreateExpanded (Default)
New-MgBetaUserProfileSkill -UserId <String> [-ResponseHeadersVariable <String>]
[-AdditionalProperties <Hashtable>] [-AllowedAudiences <String>] [-Categories <String[]>]
[-CollaborationTags <String[]>] [-CreatedBy <IMicrosoftGraphIdentitySet>] [-CreatedDateTime <DateTime>]
[-DisplayName <String>] [-Id <String>] [-Inference <IMicrosoftGraphInferenceData>] [-IsSearchable]
[-LastModifiedBy <IMicrosoftGraphIdentitySet>] [-LastModifiedDateTime <DateTime>] [-Proficiency <String>]
[-Source <IMicrosoftGraphPersonDataSources>] [-ThumbnailUrl <String>] [-WebUrl <String>]
[-Headers <IDictionary>] [-ProgressAction <ActionPreference>] [-WhatIf] [-Confirm] [<CommonParameters>]
Create
New-MgBetaUserProfileSkill -UserId <String> -BodyParameter <IMicrosoftGraphSkillProficiency>
[-ResponseHeadersVariable <String>] [-Headers <IDictionary>] [-ProgressAction <ActionPreference>] [-WhatIf]
[-Confirm] [<CommonParameters>]
CreateViaIdentityExpanded
New-MgBetaUserProfileSkill -InputObject <IPeopleIdentity> [-ResponseHeadersVariable <String>]
[-AdditionalProperties <Hashtable>] [-AllowedAudiences <String>] [-Categories <String[]>]
[-CollaborationTags <String[]>] [-CreatedBy <IMicrosoftGraphIdentitySet>] [-CreatedDateTime <DateTime>]
[-DisplayName <String>] [-Id <String>] [-Inference <IMicrosoftGraphInferenceData>] [-IsSearchable]
[-LastModifiedBy <IMicrosoftGraphIdentitySet>] [-LastModifiedDateTime <DateTime>] [-Proficiency <String>]
[-Source <IMicrosoftGraphPersonDataSources>] [-ThumbnailUrl <String>] [-WebUrl <String>]
[-Headers <IDictionary>] [-ProgressAction <ActionPreference>] [-WhatIf] [-Confirm] [<CommonParameters>]
CreateViaIdentity
New-MgBetaUserProfileSkill -InputObject <IPeopleIdentity> -BodyParameter <IMicrosoftGraphSkillProficiency>
[-ResponseHeadersVariable <String>] [-Headers <IDictionary>] [-ProgressAction <ActionPreference>] [-WhatIf]
[-Confirm] [<CommonParameters>]
DESCRIPTION
Use this API to create a new skillProficiency object in a user's profile.
Permissions [!INCLUDE permissions-table]
EXAMPLES
Example 1: Using the New-MgBetaUserProfileSkill Cmdlet
Import-Module Microsoft.Graph.Beta.People
$params = @{
Categories = @(
"Professional"
)
AllowedAudiences = "organization"
DisplayName = "API Design"
Proficiency = "generalProfessional"
CollaborationTags = @(
"ableToMentor"
)
}
# A UPN can also be used as -UserId.
New-MgBetaUserProfileSkill -UserId $userId -BodyParameter $params
This example shows how to use the New-MgBetaUserProfileSkill Cmdlet. To learn about permissions for this resource, see the permissions reference.
PARAMETERS
-AdditionalProperties
Additional Parameters
Type: Hashtable
Parameter Sets: CreateExpanded, CreateViaIdentityExpanded
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-AllowedAudiences
allowedAudiences
Type: String
Parameter Sets: CreateExpanded, CreateViaIdentityExpanded
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-BodyParameter
skillProficiency To construct, see NOTES section for BODYPARAMETER properties and create a hash table.
Type: IMicrosoftGraphSkillProficiency
Parameter Sets: Create, CreateViaIdentity
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
-Categories
Contains categories a user has associated with the skill (for example, personal, professional, hobby).
Type: String[]
Parameter Sets: CreateExpanded, CreateViaIdentityExpanded
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-CollaborationTags
Contains experience scenario tags a user has associated with the interest. Allowed values in the collection are: askMeAbout, ableToMentor, wantsToLearn, wantsToImprove.
Type: String[]
Parameter Sets: CreateExpanded, CreateViaIdentityExpanded
Aliases:
Required: False
Position: Named
Default value: None
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
Parameter Sets: CreateExpanded, CreateViaIdentityExpanded
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-CreatedDateTime
Provides the dateTimeOffset for when the entity was created.
Type: DateTime
Parameter Sets: CreateExpanded, CreateViaIdentityExpanded
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DisplayName
Contains a friendly name for the skill.
Type: String
Parameter Sets: CreateExpanded, CreateViaIdentityExpanded
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Headers
Optional headers that will be added to the request.
Type: IDictionary
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
-Id
The unique identifier for an entity. Read-only.
Type: String
Parameter Sets: CreateExpanded, CreateViaIdentityExpanded
Aliases:
Required: False
Position: Named
Default value: None
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
Parameter Sets: CreateExpanded, CreateViaIdentityExpanded
Aliases:
Required: False
Position: Named
Default value: None
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
Parameter Sets: CreateViaIdentityExpanded, CreateViaIdentity
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
-IsSearchable
.
Type: SwitchParameter
Parameter Sets: CreateExpanded, CreateViaIdentityExpanded
Aliases:
Required: False
Position: Named
Default value: 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
Parameter Sets: CreateExpanded, CreateViaIdentityExpanded
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-LastModifiedDateTime
Provides the dateTimeOffset for when the entity was created.
Type: DateTime
Parameter Sets: CreateExpanded, CreateViaIdentityExpanded
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Proficiency
skillProficiencyLevel
Type: String
Parameter Sets: CreateExpanded, CreateViaIdentityExpanded
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ProgressAction
{{ Fill ProgressAction Description }}
Type: ActionPreference
Parameter Sets: (All)
Aliases: proga
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ResponseHeadersVariable
Optional Response Headers Variable.
Type: String
Parameter Sets: (All)
Aliases: RHV
Required: False
Position: Named
Default value: None
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
Parameter Sets: CreateExpanded, CreateViaIdentityExpanded
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ThumbnailUrl
.
Type: String
Parameter Sets: CreateExpanded, CreateViaIdentityExpanded
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-UserId
The unique identifier of user
Type: String
Parameter Sets: CreateExpanded, Create
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-WebUrl
Contains a link to an information source about the skill.
Type: String
Parameter Sets: CreateExpanded, CreateViaIdentityExpanded
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Confirm
Prompts you for confirmation before running the cmdlet.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-WhatIf
Shows what would happen if the cmdlet runs. The cmdlet is not run.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.
INPUTS
Microsoft.Graph.Beta.PowerShell.Models.IMicrosoftGraphSkillProficiency
Microsoft.Graph.Beta.PowerShell.Models.IPeopleIdentity
System.Collections.IDictionary
OUTPUTS
Microsoft.Graph.Beta.PowerShell.Models.IMicrosoftGraphSkillProficiency
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 <IMicrosoftGraphSkillProficiency>: skillProficiency
[(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. The display name might not always be available or up to date. For example, if a user changes their display name the API might show the new value in a future response, but the items associated with the user won't show up as having changed when using delta.[Id <String>]: Unique identifier for the identity. When the unique identifier is unavailable, the displayName property is provided for the identity, but the id property isn't included in the response.
[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-[]>]:
[Id <String>]: The unique identifier for an entity. Read-only.[Categories <String-[]>]: Contains categories a user has associated with the skill (for example, personal, professional, hobby).[CollaborationTags <String-[]>]: Contains experience scenario tags a user has associated with the interest. Allowed values in the collection are: askMeAbout, ableToMentor, wantsToLearn, wantsToImprove.[DisplayName <String>]: Contains a friendly name for the skill.[Proficiency <String>]: skillProficiencyLevel[ThumbnailUrl <String>]:[WebUrl <String>]: Contains a link to an information source about the skill.
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. The display name might not always be available or up to date. For example, if a user changes their display name the API might show the new value in a future response, but the items associated with the user won't show up as having changed when using delta.[Id <String>]: Unique identifier for the identity. When the unique identifier is unavailable, the displayName property is provided for the identity, but the id property isn't included in the response.
[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. The display name might not always be available or up to date. For example, if a user changes their display name the API might show the new value in a future response, but the items associated with the user won't show up as having changed when using delta.[Id <String>]: Unique identifier for the identity. When the unique identifier is unavailable, the displayName property is provided for the identity, but the id property isn't included in the response.
[Device <IMicrosoftGraphIdentity>]: identity[User <IMicrosoftGraphIdentity>]: identity
SOURCE <IMicrosoftGraphPersonDataSources>: personDataSources
[(Any) <Object>]: This indicates any property can be added to this object.[Type <String-[]>]:
RELATED LINKS
https://learn.microsoft.com/powershell/module/microsoft.graph.beta.people/new-mgbetauserprofileskill