New-PnPTermSet

Creates a taxonomy term set

Syntax

New-PnPTermSet
   -Name <String>
                 -TermGroup <Id, Title or TermGroup>
                 [-Id <Guid>]
                 [-Lcid <Int>]
                 [-Contact <String>]
                 [-Description <String>]
                 [-IsOpenForTermCreation [<SwitchParameter>]]
                 [-IsNotAvailableForTagging [<SwitchParameter>]]
                 [-Owner <String>]
                 [-StakeHolders <String[]>]
                 [-CustomProperties <Hashtable>]
                 [-TermStore <Id, Name or Object>]
                 [-Connection <SPOnlineConnection>]

Examples

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

New-PnPTermSet -Name "Department" -TermGroup "Corporate"

Creates a new termset named "Department" in the group named "Corporate"

Required Parameters

-Name

The name of the termset.

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

Name, id or actualy termgroup to create the termset in.

Type:Id, Title or TermGroup
Position:Named
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
-Contact

An e-mail address for term suggestion and feedback. If left blank the suggestion feature will be disabled.

Type:String
Position:Named
Accept pipeline input:False
Accept wildcard characters:False
-CustomProperties
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 set.

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

The Id to use for the term set; 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
-IsNotAvailableForTagging

By default a term set is available to be used by end users and content editors of sites consuming this term set. Specify this switch to turn this off

Type:SwitchParameter
Position:Named
Accept pipeline input:False
Accept wildcard characters:False
-IsOpenForTermCreation

When a term set is closed, only metadata managers can add terms to this term set. When it is open, users can add terms from a tagging application. Not specifying this switch will make the term set closed.

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

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

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

The primary user or group of this term set.

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

People and groups in the organization that should be notified before major changes are made to the term set. You can enter multiple users or groups.

Type:String[]
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.TermSet