> 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

### Synopsis

FontAwesome 6 icons.

### Syntax

```powershell
New-UDIcon [-Id <String>] [-Icon <String>] [-FixedWidth] [-Inverse] [-Rotation <Int32>] [-ClassName <String>] [-Transform <String>] [-Flip <String>] [-Pull <String>] [-ListItem] [-Spin] [-Border] [-Beat] [-Fade] [-Bounce] [-BeatFade] [-Shake] [-Size <String>] [-Style <Hashtable>] [-Title <String>] [-Color <DashboardColor>] [-Solid] [<CommonParameters>]

    New-UDIcon [-Id <String>] [-Children <ScriptBlock>] [-ClassName <String>] [-Style <Hashtable>] [<CommonParameters>]
```

### 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 [<SwitchParameter>]
        Whether to use a fixed with.

Required?                    false
Position?                    named
Default value                False
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

    -Inverse [<SwitchParameter>]
        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 [<SwitchParameter>]

Required?                    false
Position?                    named
Default value                False
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

    -Spin [<SwitchParameter>]
        Whether the icon should spin.

Required?                    false
Position?                    named
Default value                False
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

    -Border [<SwitchParameter>]
        Defines the border for this icon.

Required?                    false
Position?                    named
Default value                False
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

    -Beat [<SwitchParameter>]

Required?                    false
Position?                    named
Default value                False
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

    -Fade [<SwitchParameter>]

Required?                    false
Position?                    named
Default value                False
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

    -Bounce [<SwitchParameter>]

Required?                    false
Position?                    named
Default value                False
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

    -BeatFade [<SwitchParameter>]

Required?                    false
Position?                    named
Default value                False
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

    -Shake [<SwitchParameter>]

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 [<SwitchParameter>]
        Uses the solid icon style.

Required?                    false
Position?                    named
Default value                False
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

    <CommonParameters>
        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

\-------------------------- EXAMPLE 1 --------------------------

```
PS >New-UDIcon -Icon User -Id 'icon1'

Basic Icon|Displays a user icon.




-------------------------- EXAMPLE 2 --------------------------

PS >New-UDStack -Direction 'row' -Content {
PS >    New-UDIcon -Icon 'AddressBook' -Size 'sm' -Id 'icon2'
PS >    New-UDIcon -Icon 'AddressBook' -Size 'lg' -Id 'icon3'
PS >    New-UDIcon -Icon 'AddressBook' -Size '5x' -Id 'icon4'
PS >    New-UDIcon -Icon 'AddressBook' -Size '10x' -Id 'icon5'
PS > }

Icon Size|Displays icons in different sizes.




-------------------------- EXAMPLE 3 --------------------------

PS >New-UDIcon -Icon 'AddressBook' -Size '5x' -Rotation 90 -Id 'icon6'

Rotated Icon|Rotates an icon 90 degrees.




-------------------------- EXAMPLE 4 --------------------------

PS >New-UDIcon -Icon 'AddressBook' -Size '5x' -Border -Id 'icon7'

Border Icon|Adds a border to an icon.




-------------------------- EXAMPLE 5 --------------------------

PS >New-UDIcon -Icon 'AddressBook' -Size '5x' -Color 'red' -Id 'icon8'

Color|Adds a color to an icon




-------------------------- EXAMPLE 6 --------------------------

PS >New-UDIcon -Icon 'AddressBook' -Flip 'horizontal' -Size '5x' -Id 'icon9'

Flip|Flips an icon horizontally.




-------------------------- EXAMPLE 7 --------------------------

PS >New-UDIcon -Icon 'Spinner' -Spin -Size '5x' -Id 'icon10'

Spin|Spins an icon.




-------------------------- EXAMPLE 8 --------------------------

PS >New-UDIcon -Icon 'Spinner' -Pulse -Size '5x' -Id 'icon11'

Pulse|Pulses an icon.




-------------------------- EXAMPLE 9 --------------------------

PS >New-UDHelmet -Tag 'link' -Attributes @{
PS >         href = 'https://css.gg/css'
PS >         rel = 'stylesheet'
PS >     }
PS >
PS >     New-UDIcon -Children {
PS >         New-UDHtml '<i class="gg-adidas"></i>'
PS >     }

Custom Icon Set|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=<question>&goal=<endgoal>
```

`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.
