Skip to content

Set-TerminalIconsIcon

SYNOPSIS

Set a specific icon in the current Terminal-Icons icon theme or allows swapping one glyph for another.

SYNTAX

FileExtension (Default)

Set-TerminalIconsIcon -FileExtension <String> -Glyph <String> [-Force] [-WhatIf] [-Confirm]
 [<CommonParameters>]

Directory

Set-TerminalIconsIcon -Directory <String> -Glyph <String> [-Force] [-WhatIf] [-Confirm] [<CommonParameters>]

FileName

Set-TerminalIconsIcon -FileName <String> -Glyph <String> [-Force] [-WhatIf] [-Confirm] [<CommonParameters>]

SwapGlyph

Set-TerminalIconsIcon -NewGlyph <String> -Glyph <String> [-Force] [-WhatIf] [-Confirm] [<CommonParameters>]

DESCRIPTION

Set the Terminal-Icons icon for a specific file/directory or glyph to a named glyph.

Also allows all uses of a specific glyph to be replaced with a different glyph.

EXAMPLES

EXAMPLE 1

Set-TerminalIconsIcon -FileName "README.md" -Glyph "nf-fa-file_text"

Set README.md files to display a text file icon.

EXAMPLE 2

Set-TerminalIconsIcon -FileExtension ".xml" -Glyph "nf-mdi-file_xml"

Set XML files to display an XML file icon.

EXAMPLE 3

Set-TerminalIconsIcon -Directory ".github" -Glyph "nf-mdi-github_face"

Set directories named ".github" to display an Octocat face icon.

EXAMPLE 4

Set-TerminalIconsIcon -Glyph "nf-mdi-xml" -NewGlyph "nf-mdi-file_xml"

Changes all uses of the "nf-mdi-xml" double-wide glyph to be the "nf-mdi-file_xml" single-width XML file glyph.

PARAMETERS

-Directory

The well-known directory name to match for the icon.

Type: System.String
Parameter Sets: Directory
Aliases:

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

-FileName

The well-known file name to match for the icon.

Type: System.String
Parameter Sets: FileName
Aliases:

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

-FileExtension

The file extension to match for the icon.

Type: System.String
Parameter Sets: FileExtension
Aliases:

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

-NewGlyph

The name of the new glyph to use when swapping.

Type: System.String
Parameter Sets: SwapGlyph
Aliases:

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

-Glyph

The name of the glyph to use; or, when swapping glyphs, the name of the glyph you want to change.

Type: System.String
Parameter Sets: (All)
Aliases:

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

-Force

Bypass confirmation messages.

Type: System.Management.Automation.SwitchParameter
Parameter Sets: (All)
Aliases:

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

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Type: System.Management.Automation.SwitchParameter
Parameter Sets: (All)
Aliases: wi

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

-Confirm

Prompts you for confirmation before running the cmdlet.

Type: System.Management.Automation.SwitchParameter
Parameter Sets: (All)
Aliases: cf

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

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

INPUTS

None.

The command does not accept pipeline input.

OUTPUTS

None.

NOTES

Get-TerminalIconsIconTheme

Get-TerminalIconsTheme

Get-TerminalIconsGlyphs

Back to top