New-PnPTerm

Tip

We encourage you to make improvements to this documentation. Please navigate to https://github.com/pnp/powershell/blob/dev/documentation/New-PnPTerm.md to change this file.

Creates a taxonomy term

Syntax

New-PnPTerm
   -Name <String>
   [-Id <Guid>]
   [-Lcid <Int32>]
   [-TermSet] <TaxonomyTermSetPipeBind>
   -TermGroup <TaxonomyTermGroupPipeBind>
   [-Description <String>]
   [-CustomProperties <Hashtable>]
   [-LocalCustomProperties <Hashtable>]
   [-TermStore <TaxonomyTermStorePipeBind>]
   [<CommonParameters>]

Description

This cmdlet adds a new taxonony term to a given termset.

Examples

Example 1

New-PnPTerm -TermSet "Departments" -TermGroup "Corporate" -Name "Finance"

Creates a new taxonomy term named "Finance" in the termset Departments which is located in the "Corporate" termgroup

Example 2

New-PnPTerm -TermSet "Departments" -TermGroup "Corporate" -Name "Finance" -CustomProperties @{"IsCorporate"="True"}

Creates a new taxonomy term named "Finance" in the termset Departments which is located in the "Corporate" termgroup and sets a custom property on the termset.

Parameters

-CustomProperties

Sets custom properties.

Type:Hashtable
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Description

Descriptive text to help users understand the intended use of this term.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Id

The Id to use for the term; if not specified, or provided with an empty GUID, a random GUID is generated and used.

Type:Guid
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Lcid

The locale id to use for the term. Defaults to the default language of the termstore.

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-LocalCustomProperties

Sets local custom properties

Type:Hashtable
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Name

The name of the term.

Type:String
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-TermGroup

The termgroup to create the term in.

Type:TaxonomyTermGroupPipeBind
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-TermSet

The termset to add the term to.

Type:TaxonomyTermSetPipeBind
Position:0
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-TermStore

Term store to use; if not specified the default term store is used.

Type:TaxonomyTermStorePipeBind
Aliases:TermStoreName
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False