--- 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 [-ResponseHeadersVariable ] [-AdditionalProperties ] [-AllowedAudiences ] [-Categories ] [-CollaborationTags ] [-CreatedBy ] [-CreatedDateTime ] [-DisplayName ] [-Id ] [-Inference ] [-IsSearchable] [-LastModifiedBy ] [-LastModifiedDateTime ] [-Proficiency ] [-Source ] [-ThumbnailUrl ] [-WebUrl ] [-Headers ] [-ProgressAction ] [-WhatIf] [-Confirm] [] ``` ### Create ``` New-MgBetaUserProfileSkill -UserId -BodyParameter [-ResponseHeadersVariable ] [-Headers ] [-ProgressAction ] [-WhatIf] [-Confirm] [] ``` ### CreateViaIdentityExpanded ``` New-MgBetaUserProfileSkill -InputObject [-ResponseHeadersVariable ] [-AdditionalProperties ] [-AllowedAudiences ] [-Categories ] [-CollaborationTags ] [-CreatedBy ] [-CreatedDateTime ] [-DisplayName ] [-Id ] [-Inference ] [-IsSearchable] [-LastModifiedBy ] [-LastModifiedDateTime ] [-Proficiency ] [-Source ] [-ThumbnailUrl ] [-WebUrl ] [-Headers ] [-ProgressAction ] [-WhatIf] [-Confirm] [] ``` ### CreateViaIdentity ``` New-MgBetaUserProfileSkill -InputObject -BodyParameter [-ResponseHeadersVariable ] [-Headers ] [-ProgressAction ] [-WhatIf] [-Confirm] [] ``` ## DESCRIPTION Use this API to create a new skillProficiency object in a user's profile. **Permissions** [!INCLUDE [permissions-table](~/../graphref/api-reference/beta/includes/permissions/profile-post-skills-permissions.md)] ## EXAMPLES ### Example 1: Using the New-MgBetaUserProfileSkill Cmdlet ```powershell 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](/graph/permissions-reference). ## PARAMETERS ### -AdditionalProperties Additional Parameters ```yaml Type: Hashtable Parameter Sets: CreateExpanded, CreateViaIdentityExpanded Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -AllowedAudiences allowedAudiences ```yaml 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. ```yaml 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). ```yaml 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. ```yaml 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. ```yaml 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. ```yaml 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. ```yaml 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. ```yaml 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. ```yaml 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. ```yaml 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. ```yaml Type: IPeopleIdentity Parameter Sets: CreateViaIdentityExpanded, CreateViaIdentity Aliases: Required: True Position: Named Default value: None Accept pipeline input: True (ByValue) Accept wildcard characters: False ``` ### -IsSearchable . ```yaml 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. ```yaml 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. ```yaml Type: DateTime Parameter Sets: CreateExpanded, CreateViaIdentityExpanded Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Proficiency skillProficiencyLevel ```yaml 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 }} ```yaml 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. ```yaml 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. ```yaml Type: IMicrosoftGraphPersonDataSources Parameter Sets: CreateExpanded, CreateViaIdentityExpanded Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -ThumbnailUrl . ```yaml 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 ```yaml 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. ```yaml 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. ```yaml 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. ```yaml 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](http://go.microsoft.com/fwlink/?LinkID=113216). ## 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 ``: skillProficiency - `[(Any)