> 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-udslider.md).

# New-UDSlider

New-UDSlider creates a draggable slider control in PowerShell Universal for selecting a value or range within defined minimum and maximum bounds.

### Synopsis

A slider component.

### Syntax

```powershell
New-UDSlider [[-Id] <String>] [[-Value] <Int32[]>] [[-Minimum] <Int32>] [[-Maximum] <Int32>] [-Disabled] [-Marks] [[-OnChange] <Endpoint>] [[-Orientation] <String>] [[-Step] <Int32>] [[-ValueLabelDisplay] <String>] [[-ClassName] <String>] [[-Color] <String>] [<CommonParameters>]
```

### Description

A slider component. Sliders can be used to define values within a range or selecting a range of values. You can use this component with New-UDForm.

### Parameters

#### -Id

The ID of this component.

```
Required?                    false
Position?                    1
Default value                ([Guid]::NewGuid())
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false
```

#### -Value \<Int32\[]>

The value of the slider.

```
Required?                    false
Position?                    2
Default value                0
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false
```

#### -Minimum

The minimum value of the slider.

```
Required?                    false
Position?                    3
Default value                0
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false
```

#### -Maximum

The maximum value of the slider.

```
Required?                    false
Position?                    4
Default value                100
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false
```

#### -Disabled

Whether the slider is disabled.

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

#### -Marks

Whether to display marks on the slider.

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

#### -OnChange

A script block that is invoked when the slider value changes. You can access the slider value within the script block by referencing the $EventData variable.

```
Required?                    false
Position?                    5
Default value
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false
```

#### -Orientation

The orientation of the slider.

```
Required?                    false
Position?                    6
Default value                horizontal
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false
```

#### -Step

Step size of the slider.

```
Required?                    false
Position?                    7
Default value                1
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false
```

#### -ValueLabelDisplay

Whether to display value labels.

```
Required?                    false
Position?                    8
Default value                auto
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false
```

#### -ClassName

A CSS class to apply to the slider.

```
Required?                    false
Position?                    9
Default value
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false
```

#### -Color

The color of the slider. Defaults to 'primary'. Valid values: "primary", "secondary"

```
Required?                    false
Position?                    10
Default value                primary
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 Slider

```powershell
New-UDSlider -Value 50 -Minimum 0 -Maximum 100 -OnChange {
   Show-UDToast -Message "Slider value changed to $($EventData.value)"
} -Id 'slider1'
```

Creates a basic slider.

#### Example 2: Slider with Marks

```powershell
New-UDSlider -Value 50 -Minimum 0 -Maximum 100 -Marks -OnChange {
   Show-UDToast -Message "Slider value changed to $($EventData.value)"
} -Id 'slider2'
```

Creates a slider with marks.

#### Example 3: Vertical Slider

```powershell
New-UDElement -Tag 'div' -Content {
   New-UDSlider -Orientation vertical -Id 'slider3'
} -Attributes @{
   style = @{
       height = '200px'
   }
}
```

Creates a vertical slider.

#### Example 4: Disabled Slider

```powershell
New-UDSlider -Value 50 -Minimum 0 -Maximum 100 -Disabled -Id 'slider4'
```

Creates a disabled slider.

#### Example 5: Slider with Value Labels

```powershell
New-UDSlider -Value 50 -Minimum 0 -Maximum 100 -ValueLabelDisplay on -Id 'slider5'
```

Creates a slider with value labels.

#### Example 6: Slider with Step

```powershell
New-UDSlider -Value 50 -Minimum 0 -Maximum 100 -Step 10 -Id 'slider6'
```

Creates a slider with a step size of 10.


---

# 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-udslider.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.
