Add-PnPTermToTerm

SYNOPSIS

Adds a new term to an existing term.

SYNTAX

Add-PnPTermToTerm -ParentTermId <Guid> -Name <String> [-Id <Guid>] [-Lcid <Int32>]
  [-LocalCustomProperties <Hashtable>]
 [-TermStore <Guid>]
 [-Connection <PnPConnection>]

DESCRIPTION

This cmdlet adds a new taxonomy term as a child term to an existing term.

EXAMPLES

EXAMPLE 1

Add-PnPTermToTerm -ParentTermId 2d1f298b-804a-4a05-96dc-29b667adec62 -Name SubTerm -CustomProperties @{"Department"="Marketing"}

Creates a new taxonomy child term named "SubTerm" in the specified term by id 2d1f298b-804a-4a05-96dc-29b667adec62.

EXAMPLE 2

$parentTerm = Get-PnPTerm -Name Marketing -TermSet Departments -TermGroup Corporate
Add-PnPTermToTerm -ParentTermId $parentTerm.Id -Name "Conference Team"

Creates a new taxonomy child term named "Conference Team" in the specified term called Marketing which is located in the Departments term set.

PARAMETERS

-ParentTermId

The Id of the parent term.

Type: Guid
Parameter Sets: (All)

Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-Name

The name of the term.

Type: String
Parameter Sets: (All)

Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-Description

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

Type: String
Parameter Sets: (All)

Required: False
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 the empty GUID, a random GUID is generated and used.

Type: Guid
Parameter Sets: (All)

Required: False
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 current locale id.

Type: Int32
Parameter Sets: (All)

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-CustomProperties

Custom Properties

Type: Hashtable
Parameter Sets: (All)

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-LocalCustomProperties