Remove-PnPTerm
SYNOPSIS
Removes a taxonomy term from the term store.
SYNTAX
By Term Id
Remove-PnPTerm -Identity <Guid> [-TermStore <TaxonomyTermStorePipeBind>]
[-WhatIf] [-Confirm]
By Term Name
Remove-PnPTerm -Identity <String> -TermSet <TaxonomyTermSetPipeBind>
-TermGroup <TaxonomyTermGroupPipeBind> [-TermStore <TaxonomyTermStorePipeBind>]
[-Connection <PnPConnection>] [-WhatIf] [-Confirm]
DESCRIPTION
This cmdlet removes a term from the term store.
EXAMPLES
Example 1
Remove-PnPTerm -Identity 3d9e60e8-d89c-4cd4-af61-a010cf93b380
Removes a term by id.
Example 2
Remove-PnPTerm -Identity "Marketing" -TermSet "Departments" -TermGroup "Corporate"
Removes a term by name.
PARAMETERS
-Confirm
Prompts you for confirmation before running the cmdlet.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Identity
Specifies which term to remove.
Type: TaxonomyTermPipeBind
Parameter Sets: (All)
Aliases:
Required: True
Position: 0
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
-TermGroup
Specifies which termgroup to find the termset in.
Type: TaxonomyTermGroupPipeBind
Parameter Sets: By Term Name
Aliases:
Required: True
Position: 0
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
-TermSet
Specifies which termset to find the term in if the identity of the term is specified as a string.
Type: TaxonomyTermSetPipeBind
Parameter Sets: By Term Name
Aliases:
Required: True
Position: 0
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
-TermStore
Term store to use; if not specified the default term store is used.
Type: TaxonomyTermStorePipeBind
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-WhatIf
Shows what would happen if the cmdlet runs. The cmdlet is not run.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False