> For the complete documentation index, see [llms.txt](https://docs.devolutions.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.devolutions.net/powershell-universal/powershell-commands/new-udicon.md). # New-UDIcon New-UDIcon displays a FontAwesome 6 icon in PowerShell Universal, with options for size, color, rotation, spin, and other animations. ### Synopsis FontAwesome 6 icons. ### Syntax ```powershell New-UDIcon [-Id ] [-Icon ] [-FixedWidth] [-Inverse] [-Rotation ] [-ClassName ] [-Transform ] [-Flip ] [-Pull ] [-ListItem] [-Spin] [-Border] [-Beat] [-Fade] [-Bounce] [-BeatFade] [-Shake] [-Size ] [-Style ] [-Title ] [-Color ] [-Solid] [] New-UDIcon [-Id ] [-Children ] [-ClassName ] [-Style ] [] ``` ### Description Creates a new icon. ### Parameters #### -Id The ID of this component. ``` Required? false Position? named Default value ([Guid]::NewGuid()).ToString() Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Icon The Icon to display. This is a FontAwesome 6 icon name. ``` Required? false Position? named Default value User Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Children ``` Required? false Position? named Default value Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -FixedWidth Whether to use a fixed with. ``` Required? false Position? named Default value False Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Inverse Whether to invert the colors of the icon. ``` Required? false Position? named Default value False Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Rotation The amount of degrees to rotate the icon. ``` Required? false Position? named Default value 0 Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -ClassName Custom CSS class names to apply to the icon. ``` Required? false Position? named Default value Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Transform A CSS transform to apply to the icon. ``` Required? false Position? named Default value Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Flip Whether to flip the icon. ``` Required? false Position? named Default value Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Pull Whether to flip the icon. ``` Required? false Position? named Default value Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -ListItem ``` Required? false Position? named Default value False Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Spin Whether the icon should spin. ``` Required? false Position? named Default value False Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Border Defines the border for this icon. ``` Required? false Position? named Default value False Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Beat ``` Required? false Position? named Default value False Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Fade ``` Required? false Position? named Default value False Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Bounce ``` Required? false Position? named Default value False Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -BeatFade ``` Required? false Position? named Default value False Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Shake ``` Required? false Position? named Default value False Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Size The size of the icon. Valid values are: "xs", "sm", "lg", "1x", "2x", "3x", "4x", "5x", "6x", "7x", "8x", "9x", "10x" ``` Required? false Position? named Default value sm Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Style A CSS style to apply to the icon. ``` Required? false Position? named Default value @{} Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Title ``` Required? false Position? named Default value Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Color The color of this icon. ``` Required? false Position? named Default value Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Solid Uses the solid icon style. ``` Required? false Position? named Default value False Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### Common parameters This cmdlet supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, PipelineVariable, and OutVariable. For more information, see [about\_CommonParameters](https://go.microsoft.com/fwlink/?LinkID=113216). ### Outputs ### Examples #### Example 1: Basic Icon ```powershell New-UDIcon -Icon User -Id 'icon1' ``` Displays a user icon. #### Example 2: Icon Size ```powershell New-UDStack -Direction 'row' -Content { New-UDIcon -Icon 'AddressBook' -Size 'sm' -Id 'icon2' New-UDIcon -Icon 'AddressBook' -Size 'lg' -Id 'icon3' New-UDIcon -Icon 'AddressBook' -Size '5x' -Id 'icon4' New-UDIcon -Icon 'AddressBook' -Size '10x' -Id 'icon5' } ``` Displays icons in different sizes. #### Example 3: Rotated Icon ```powershell New-UDIcon -Icon 'AddressBook' -Size '5x' -Rotation 90 -Id 'icon6' ``` Rotates an icon 90 degrees. #### Example 4: Border Icon ```powershell New-UDIcon -Icon 'AddressBook' -Size '5x' -Border -Id 'icon7' ``` Adds a border to an icon. #### Example 5: Color ```powershell New-UDIcon -Icon 'AddressBook' -Size '5x' -Color 'red' -Id 'icon8' ``` Adds a color to an icon #### Example 6: Flip ```powershell New-UDIcon -Icon 'AddressBook' -Flip 'horizontal' -Size '5x' -Id 'icon9' ``` Flips an icon horizontally. #### Example 7: Spin ```powershell New-UDIcon -Icon 'Spinner' -Spin -Size '5x' -Id 'icon10' ``` Spins an icon. #### Example 8: Pulse ```powershell New-UDIcon -Icon 'Spinner' -Pulse -Size '5x' -Id 'icon11' ``` Pulses an icon. #### Example 9: Custom Icon Set ```powershell New-UDHelmet -Tag 'link' -Attributes @{ href = 'https://css.gg/css' rel = 'stylesheet' } New-UDIcon -Children { New-UDHtml '' } ``` Uses the css.gg icon set. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.devolutions.net/powershell-universal/powershell-commands/new-udicon.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.