> 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/de/powershell-befehle/new-udselect.md).

# New-UDSelect

New-UDSelect erstellt ein Dropdown-Auswahlfeld in PowerShell Universal und unterstützt gruppierte Optionen über New-UDSelectGroup sowie Einzel- oder Mehrfachauswahl.

### Übersicht

Erstellt ein neues Auswahlfeld.

### Syntax

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

### Beschreibung

Erstellt ein neues Auswahlfeld. Auswahlfelder können mehrere Optionen und Optionsgruppen enthalten. Auswahlfelder können auch Mehrfachauswahl unterstützen.

### Parameter

#### -Id

Die ID der Komponente. Standardmäßig ist dies eine zufällige GUID.

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

#### -Option

Optionen, die in dieses Auswahlfeld aufgenommen werden sollen. Dies kann entweder New-UDSelectOption oder New-UDSelectGroup sein.

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

Die Beschriftung, die mit dem Auswahlfeld angezeigt wird.

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

#### -OnChange

Ein Skriptblock, der ausgeführt wird, wenn sich das Skript ändert. $EventData ist ein Array der ausgewählten Werte.

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

#### -DefaultValue

Der standardmäßig ausgewählte Wert.

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

#### -Disabled

Ob dieses Auswahlfeld deaktiviert ist.

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

#### -Multiple

Ob Sie mehrere Werte auswählen können.

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

#### -MaxWidth

Die maximale Breite des Auswahlfelds.

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

#### -ClassName

Eine CSS-Klasse, die auf das Auswahlfeld angewendet wird.

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

#### -FullWidth

Das Auswahlfeld auf die volle Breite der übergeordneten Komponente strecken.

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

#### -OnEnter

Ein Skriptblock, der aufgerufen wird, wenn der Benutzer die Eingabetaste drückt. Die Variable $EventData enthält den aktuellen Wert des Textfelds.

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

#### -Variant

Die Variante des Auswahlfelds. Kann filled, outlined oder standard sein.

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

#### -Icon

Das Symbol, das neben dem Textfeld angezeigt wird. Verwenden Sie New-UDIcon, um ein Symbol zu erstellen.

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

#### -Sx

Eine Hashtable mit Stilen, die auf das Auswahlfeld angewendet werden.

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

#### -Checkbox

Ob bei Mehrfachauswahl Kontrollkästchen angezeigt werden sollen.

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

#### Allgemeine Parameter

Dieses Cmdlet unterstützt die allgemeinen Parameter: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, PipelineVariable und OutVariable. Weitere Informationen finden Sie unter [about\_CommonParameters](https://go.microsoft.com/fwlink/?LinkID=113216).

### Ausgaben

### Beispiele

#### Beispiel 1: Einfaches Auswahlfeld

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

Ein einfaches Auswahlfeld mit drei Optionen

#### Beispiel 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
```

Ein Auswahlfeld mit einem OnChange-Skriptblock, der einen Toast anzeigt, wenn sich der Wert ändert.

#### Beispiel 3: Deaktiviert

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

Ein deaktiviertes Auswahlfeld.

#### Beispiel 4: Mehrfachauswahl

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

Ein Auswahlfeld, das mehrere Auswahlen zulässt.

#### Beispiel 5: Mehrfachauswahl mit Kontrollkästchen

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

Ein Auswahlfeld, das mehrere Auswahlen mit Kontrollkästchen zulässt.

#### Beispiel 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
```

Ein Auswahlfeld mit der Variante outlined.

#### Beispiel 7: Symbol

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

Ein Auswahlfeld mit einem Symbol.

#### Beispiel 8: Gruppiert

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

Ein Auswahlfeld mit Optionsgruppen.

\[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/de/powershell-befehle/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.