Table of Contents

New-PnPTermGroup

SYNOPSIS

Creates a taxonomy term group

SYNTAX

New-PnPTermGroup -Name <String> [-Id <Guid>] [-Description <String>]
 [-TermStore <PnP.PowerShell.Commands.Base.PipeBinds.GenericObjectNameIdPipeBind`1[Microsoft.SharePoint.Client.Taxonomy.TermStore]>] [-Contributors <string []>] [-Managers <string []>]
 [-Connection <PnPConnection>] 

DESCRIPTION

Allows to create a taxonomy term group.

EXAMPLES

EXAMPLE 1

New-PnPTermGroup -GroupName "Countries"

Creates a new taxonomy term group named "Countries"

EXAMPLE 2

New-PnPTermGroup -GroupName "Countries" -Contributors @("i:0#.f|membership|pradeepg@gautamdev.onmicrosoft.com","i:0#.f|membership|adelev@gautamdev.onmicrosoft.com") -Managers @("i:0#.f|membership|alexw@gautamdev.onmicrosoft.com","i:0#.f|membership|diegos@gautamdev.onmicrosoft.com")

Creates a new taxonomy term group named "Countries" and sets the users as contributors and managers of the term group. The user names for contributors and managers need to be encoded claim for the specified login names.

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: PnPConnection
Parameter Sets: (All)

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

-Description

Description to use for the term group.

Type: String
Parameter Sets: (All)

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

-Id

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

Type: Guid
Parameter Sets: (All)
Aliases: GroupId

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

-Name

Name of the taxonomy term group to create.

Type: String
Parameter Sets: (All)
Aliases: GroupName

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

-TermStore

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

Type: PnP.PowerShell.Commands.Base.PipeBinds.GenericObjectNameIdPipeBind`1[Microsoft.SharePoint.Client.Taxonomy.TermStore]
Parameter Sets: (All)
Aliases: TermStoreName

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

-Managers

The manager of the term group who can create/edit term sets in the group as well as add/remove contributors. The user names for managers need to be encoded claim for the specified login names.

Type: string[]
Parameter Sets: (All)
Aliases: 

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

-Contributors

The contributor to the term group who can create/edit term sets in the group. The user names for contributors need to be encoded claim for the specified login names.

Type: string[]
Parameter Sets: (All)
Aliases: 

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

Microsoft 365 Patterns and Practices