> 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/fr/commandes-powershell/new-udselect.md).

# New-UDSelect

New-UDSelect crée une entrée de sélection déroulante dans PowerShell Universal, prenant en charge les options groupées via New-UDSelectGroup et la sélection simple ou multiple.

### Synopsis

Crée une nouvelle sélection.

### Syntaxe

```powershell
New-UDSelect [[-Id] <String>] [[-Option] <ScriptBlock>] [[-Label] <String>] [[-OnChange] <Endpoint>] [[-DefaultValue] <Object>] [-Disabled] [-Multiple] [[-MaxWidth] <String>] [[-ClassName] <String>] [-FullWidth] [[-OnEnter] <Endpoint>] [[-Variant] <String>] [[-Icon] <Object>] [[-Sx] <Hashtable>] [-Checkbox] [<CommonParameters>]
```

### Description

Crée une nouvelle sélection. Les sélections peuvent avoir plusieurs options et groupes d'options. Les sélections peuvent aussi être à sélection multiple.

### Paramètres

#### -Id

L'ID du composant. Il s'agit par défaut d'un GUID aléatoire.

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

#### -Option

Options à inclure dans cette sélection. Il peut s'agir de New-UDSelectOption ou de New-UDSelectGroup.

```
Required?                    false
Position?                    2
Default value                {
                    New-UDSelectOption -Name 'Option 1' -Value 1
                    New-UDSelectOption -Name 'Option 2' -Value 2
                }
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false
```

#### -Label

L'étiquette à afficher avec la sélection.

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

#### -OnChange

Un bloc de script qui est exécuté lorsque le script change. $EventData sera un tableau des valeurs sélectionnées.

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

#### -DefaultValue

La valeur sélectionnée par défaut.

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

#### -Disabled

Si cette sélection est désactivée.

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

#### -Multiple

Si vous pouvez sélectionner plusieurs valeurs.

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

#### -MaxWidth

La largeur maximale de la sélection.

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

#### -ClassName

Une classe CSS à appliquer à la sélection.

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

#### -FullWidth

Étirer la sélection sur toute la largeur du composant parent.

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

#### -OnEnter

Un bloc de script qui est appelé lorsque l'utilisateur appuie sur la touche Entrée. La variable $EventData contiendra la valeur actuelle de la zone de texte.

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

#### -Variant

La variante de la sélection. Peut être filled, outlined ou standard.

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

#### -Icon

L'icône à afficher à côté de la zone de texte. Utilisez New-UDIcon pour créer une icône.

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

#### -Sx

Une table de hachage de styles à appliquer à la sélection.

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

#### -Checkbox

S'il faut afficher des cases à cocher lors de l'utilisation de la sélection multiple.

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

#### Paramètres communs

Cette applet de commande prend en charge les paramètres communs : Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, PipelineVariable et OutVariable. Pour plus d'information, voir [about\_CommonParameters](https://go.microsoft.com/fwlink/?LinkID=113216).

### Sorties

### Exemples

#### Exemple 1 : Sélection de base

```powershell
New-UDSelect -Label 'Select' -Id 'select1' -Option {
   New-UDSelectOption -Name "One" -Value 1
   New-UDSelectOption -Name "Two" -Value 2
   New-UDSelectOption -Name "Three" -Value 3
} -FullWidth
```

Une sélection de base avec trois options

#### Exemple 2 : OnChange

```powershell
New-UDSelect -Label 'Select' -Id 'select2' -Option {
   New-UDSelectOption -Name "One" -Value 1
   New-UDSelectOption -Name "Two" -Value 2
   New-UDSelectOption -Name "Three" -Value 3
} -DefaultValue 2 -OnChange {
   Show-UDToast -Message $EventData
} -FullWidth
```

Une sélection avec un bloc de script OnChange qui affiche une notification lorsque la valeur change.

#### Exemple 3 : Désactivée

```powershell
New-UDSelect -Label 'Select' -Id 'select3' -Option {
   New-UDSelectOption -Name "One" -Value 1
   New-UDSelectOption -Name "Two" -Value 2
   New-UDSelectOption -Name "Three" -Value 3
} -Disabled -FullWidth
```

Une sélection désactivée.

#### Exemple 4 : Multiple

```powershell
New-UDSelect -Label 'Select' -Id 'select4' -Option {
   New-UDSelectOption -Name "One" -Value 1
   New-UDSelectOption -Name "Two" -Value 2
   New-UDSelectOption -Name "Three" -Value 3
} -Multiple -FullWidth
```

Une sélection qui permet des sélections multiples.

#### Exemple 5 : Multiple avec cases à cocher

```powershell
New-UDSelect -Label 'Select' -Id 'select4' -Option {
   New-UDSelectOption -Name "One" -Value 1
   New-UDSelectOption -Name "Two" -Value 2
   New-UDSelectOption -Name "Three" -Value 3
} -Multiple -FullWidth -Checkbox
```

Une sélection qui permet des sélections multiples avec des cases à cocher.

#### Exemple 6 : Outlined

```powershell
New-UDSelect -Label 'Select' -Id 'select5' -Option {
   New-UDSelectOption -Name "One" -Value 1
   New-UDSelectOption -Name "Two" -Value 2
   New-UDSelectOption -Name "Three" -Value 3
} -Variant outlined -FullWidth
```

Une sélection avec une variante outlined.

#### Exemple 7 : Icône

```powershell
New-UDSelect -Label 'Select' -Id 'select6' -Option {
   New-UDSelectOption -Name "One" -Value 1
   New-UDSelectOption -Name "Two" -Value 2
   New-UDSelectOption -Name "Three" -Value 3
} -FullWidth -Icon (New-UDIcon -Icon Home)
```

Une sélection avec une icône.

#### Exemple 8 : Groupée

```powershell
New-UDSelect -Label 'Select' -Id 'select7' -Option {
   New-UDSelectGroup -Name "Category 1" -Option {
       New-UDSelectOption -Name "One" -Value 1
       New-UDSelectOption -Name "Two" -Value 2
   }
   New-UDSelectGroup -Name "Category 2" -Option {
       New-UDSelectOption -Name "Three" -Value 3
       New-UDSelectOption -Name "Four" -Value 4
   }
} -FullWidth
```

Une sélection avec des groupes d'options.

\[Component("Select", "ListDropdown", "Creates a new card.")]


---

# 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/fr/commandes-powershell/new-udselect.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.