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

# New-UDAutocomplete

New-UDAutocomplete erstellt eine Texteingabe-Komponente in PowerShell Universal, die um ein filterbares Panel mit vorgeschlagenen Optionen erweitert ist.

New-UDAutocomplete erstellt eine Texteingabe-Komponente in PowerShell Universal, die um ein filterbares Panel mit vorgeschlagenen Optionen erweitert ist.

### Übersicht

Die Autovervollständigung ist eine normale Texteingabe, die um ein Panel mit vorgeschlagenen Optionen erweitert ist.

### Syntax

```powershell
New-UDAutocomplete [-Id <String>] [-Label <String>] [-Value <Object>] [-OnChange <Endpoint>] [-Options <Object>] [-FullWidth] [-AutoSelect] [-Variant <String>] [-Multiple] [-ClassName <String>] [-Icon <Object>] [-OnEnter <Endpoint>] [-Disabled] [-Aria <ScriptBlock>] [<CommonParameters>]

New-UDAutocomplete [-Id <String>] [-Label <String>] [-Value <Object>] [-OnChange <Endpoint>] -OnLoadOptions <Endpoint> [-FullWidth] [-AutoSelect] [-Variant <String>] [-Multiple] [-ClassName <String>] [-Icon <Object>] [-OnEnter <Endpoint>] [-Disabled] [-Aria <ScriptBlock>] [<CommonParameters>]
```

### Beschreibung

Autovervollständigungs-Textfelder können verwendet werden, damit der Benutzer aus einer großen Liste statischer oder dynamischer Elemente auswählen kann. Die Eingabe im Textfeld filtert die Liste.

### Parameter

#### -Id

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

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

#### -Label

Die für das Textfeld anzuzeigende Bezeichnung.

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

#### -Value

Der Wert des Textfelds.

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

#### -OnChange

Ein Skriptblock, der aufgerufen wird, wenn sich die Auswahl ändert.

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

#### -OnLoadOptions

Ein Skriptblock, der aufgerufen wird, wenn der Benutzer beginnt, in das Textfeld zu tippen. Die Variable $Body enthält den eingegebenen Text. Sie sollten ein JSON-Array mit Werten zurückgeben, die das Ergebnis der Benutzereingabe sind.

```
Type                         Endpoint
Required?                    true
Position?                    named
Default value
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false
```

#### -Options

Statische Optionen, die in der Auswahlliste angezeigt werden. Wenn der Benutzer tippt, werden diese Optionen gefiltert.

```
Type                         Object
Required?                    false
Position?                    named
Default value                @()
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false
```

#### -FullWidth

Ob die Komponente die gesamte Breite ihres übergeordneten Elements einnehmen soll.

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

#### -AutoSelect

Ob die Komponente automatisch ausgewählt werden soll, wenn es im Optionen-Array insgesamt nur eine Option gab.

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

#### -Variant

Die Variante des Textfelds. Gültige Werte sind: "filled", "outlined", "standard"

```
Type                         String
Required?                    false
Position?                    named
Default value                standard
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false
```

#### -Multiple

Ob mehrere Elemente ausgewählt werden können.

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

#### -ClassName

Eine CSS-Klasse, die auf die Komponente angewendet wird.

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

#### -Icon

Das Symbol, das vor dem Textfeld angezeigt wird. Verwenden Sie New-UDIcon, um den Wert für diesen Parameter zu erstellen.

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

#### -OnEnter

Ein Skriptblock, der aufgerufen wird, wenn der Benutzer im Autovervollständigungs-Textfeld die Eingabetaste drückt.

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

#### -Disabled

Ob diese Autovervollständigung deaktiviert ist.

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

#### -Aria

Ein Skriptblock, der ARIA-Attribute für die Autovervollständigungs-Komponente definiert.

```
Type                         ScriptBlock
Required?                    false
Position?                    named
Default value
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: Einfache Autovervollständigung

```powershell
New-UDAutocomplete -Options @('Test', 'Test2', 'Test3', 'Test4') -Id 'autocomplete1' -FullWidth
```

Der Wert muss aus einer vordefinierten Menge zulässiger Werte gewählt werden.

#### Beispiel 2: Mehrfachauswahl

```powershell
New-UDAutocomplete -Options @("Test", "No", "Yes") -Multiple -Id 'autocomplete2' -FullWidth
```

Dem Benutzer die Auswahl mehrerer Werte erlauben.

#### Beispiel 3: Varianten

```powershell
New-UDStack -Content {
   New-UDAutocomplete -Options @("Test", "No", "Yes") -Variant 'filled' -Id 'autocomplete3' -FullWidth
   New-UDAutocomplete -Options @("Test", "No", "Yes") -Variant 'outlined' -Id 'autocomplete4' -FullWidth
   New-UDAutocomplete -Options @("Test", "No", "Yes") -Variant 'standard' -Id 'autocomplete5' -FullWidth
} -Direction 'column' -FullWidth
```

Den Stil des Autovervollständigungs-Textfelds ändern.

#### Beispiel 4: Änderungen behandeln

```powershell
New-UDAutocomplete -Options @("Test", "No", "Yes") -OnChange {
   Show-UDToast $EventData
} -Id 'autocomplete6' -FullWidth
```

PowerShell ausführen, wenn sich die Autovervollständigung ändert.

#### Beispiel 5: OnEnter

```powershell
New-UDAutocomplete -Options @("Test", "No", "Yes") -OnEnter {
   Show-UDToast $EventData
} -Id 'autocomplete7' -FullWidth
```

PowerShell ausführen, wenn der Benutzer die Eingabetaste drückt.

#### Beispiel 6: Asynchrone Optionen

```powershell
New-UDAutocomplete -OnLoadOptions {
  @('Test', 'Test2', 'Test3', 'Test4') | Where-Object { $_ -match $Body } | ConvertTo-Json
} -Id 'autocomplete8' -FullWidth
```

Erstellt eine Autovervollständigung mit einer dynamisch gefilterten Menge von Optionen.

#### Beispiel 7: Gruppierte Optionen

```powershell
New-UDAutocomplete -Options @(
   New-UDAutocompleteOption -Name 'Test' -Value 'test' -Group 'Group1'
   New-UDAutocompleteOption -Name 'Test2' -Value 'test2' -Group 'Group1'
   New-UDAutocompleteOption -Name 'Test3' -Value 'test3' -Group 'Group2'
   New-UDAutocompleteOption -Name 'Test4' -Value 'test4' -Group 'Group2'
) -Id 'autocomplete9' -FullWidth
```


---

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