New-PnPTerm

Creates a taxonomy term

Syntax

New-PnPTerm
   -Name <String>
              -TermSet <Id, Title or TaxonomyItem>
              -TermGroup <Id, Title or TermGroup>
              [-Id <Guid>]
              [-Lcid <Int>]
              [-Description <String>]
              [-CustomProperties <Hashtable>]
              [-LocalCustomProperties <Hashtable>]
              [-TermStore <Id, Name or Object>]
              [-Connection <SPOnlineConnection>]

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

Required Parameters

-Name

The name of the term.

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

The termgroup to create the term in.

Type:Id, Title or TermGroup
Position:Named
Accept pipeline input:True
Accept wildcard characters:False
-TermSet

The termset to add the term to.

Type:Id, Title or TaxonomyItem
Position:0
Accept pipeline input:True
Accept wildcard characters:False

Optional Parameters

-Connection

Optional connection to be used by the cmdlet. Retrieve the value for this parameter by either specifying -ReturnConnection on Connect-PnPOnline or by executing Get-PnPConnection.

Type:SPOnlineConnection
Position:Named
Accept pipeline input:False
Accept wildcard characters:False
-CustomProperties

Custom Properties

Type:Hashtable
Position:Named
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
Accept pipeline input:False
Accept wildcard characters:False
-Id

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

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

The locale id to use for the term. Defaults to the current locale id.

Type:Int
Position:Named
Accept pipeline input:False
Accept wildcard characters:False
-LocalCustomProperties

Custom Properties

Type:Hashtable
Position:Named
Accept pipeline input:False
Accept wildcard characters:False
-TermStore

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

Type:Id, Name or Object
Aliases:TermStoreName
Position:Named
Accept pipeline input:False
Accept wildcard characters:False

Outputs

Microsoft.SharePoint.Client.Taxonomy.Term