Search Results for

    Show / Hide 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
    

    RELATED LINKS

    Microsoft 365 Patterns and Practices

    Back to top Generated by DocFX spacer