Skip to content

Latest commit

 

History

History
164 lines (123 loc) · 3.01 KB

New-PnPTerm.md

File metadata and controls

164 lines (123 loc) · 3.01 KB
external help file applicable schema
SharePoint Server 2013, SharePoint Server 2016, SharePoint Online
2.0.0

New-PnPTerm

SYNOPSIS

Creates a taxonomy term

SYNTAX

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

EXAMPLES

------------------EXAMPLE 1------------------

PS:> 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

PARAMETERS

-CustomProperties

Custom Properties

Type: Hashtable
Parameter Sets: (All)

Required: False
Position: Named
Accept pipeline input: False

-Description

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

Type: String
Parameter Sets: (All)

Required: False
Position: Named
Accept pipeline input: 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
Accept pipeline input: False

-Lcid

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

Type: Int
Parameter Sets: (All)

Required: False
Position: Named
Accept pipeline input: False

-LocalCustomProperties

Custom Properties

Type: Hashtable
Parameter Sets: (All)

Required: False
Position: Named
Accept pipeline input: False

-Name

The name of the term.

Type: String
Parameter Sets: (All)

Required: True
Position: Named
Accept pipeline input: True

-TermGroup

The termgroup to create the term in.

Type: Id, Title or TermGroup
Parameter Sets: (All)

Required: True
Position: Named
Accept pipeline input: True

-TermSet

The termset to add the term to.

Type: Id, Title or TaxonomyItem
Parameter Sets: (All)

Required: True
Position: 0
Accept pipeline input: True

-TermStore

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

Type: Id, Name or Object
Parameter Sets: (All)
Aliases: TermStoreName

Required: False
Position: Named
Accept pipeline input: False

-Connection

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

Type: SPOnlineConnection
Parameter Sets: (All)

Required: False
Position: Named
Accept pipeline input: False

OUTPUTS

RELATED LINKS

SharePoint Developer Patterns and Practices