> 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/set-psuaitool.md).

# Set-PSUAiTool

## SYNOPSIS

Aktualisiert eine bestehende KI-Tool-Definition.

## SYNTAX

### Id

```
Set-PSUAiTool [-Id] <Int64> [-Name <String>] [-Description <String>] [-Authenticated <Boolean>]
 [-Roles <String[]>] [-ScriptFullPath <String>] [-Mcp] [-ComputerName <String>] [-AppToken <String>]
 [-Credential <PSCredential>] [-UseDefaultCredentials] [-Integrated] [-TrustCertificate] [-Cookies]
 [<CommonParameters>]
```

### AiTool

```
Set-PSUAiTool [-AiTool] <AiTool> [-Name <String>] [-Description <String>] [-Authenticated <Boolean>]
 [-Roles <String[]>] [-ScriptFullPath <String>] [-Mcp] [-ComputerName <String>] [-AppToken <String>]
 [-Credential <PSCredential>] [-UseDefaultCredentials] [-Integrated] [-TrustCertificate] [-Cookies]
 [<CommonParameters>]
```

## DESCRIPTION

Lädt ein KI-Tool anhand der Id oder eines Pipeline-Objekts und wendet nur die dem Cmdlet übergebenen Felder an. Verwenden Sie dieses Cmdlet, um Metadaten, Autorisierung, Skriptpfade oder die MCP-Bereitstellung zu ändern.

## EXAMPLES

### Beispiel 1

```powershell
PS C:\> Set-PSUAiTool -Id 5 -Description "Ticket lookup and updates" -Authenticated $true -Roles HelpDesk,Admin -Mcp
```

Aktualisiert das KI-Tool 5 mit einer neuen Beschreibung, Rollenliste und MCP-Bereitstellung.

## PARAMETERS

### -AiTool

Gibt das KI-Tool an, auf das die Aktion angewendet wird.

```yaml
Type: AiTool
Parameter Sets: AiTool
Aliases:

Required: True
Position: 0
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
```

### -AppToken

Gibt das App-Token an, das bei der Authentifizierung an der PowerShell Universal-Verwaltungs-API verwendet wird.

```yaml
Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -Authenticated

Erfordert authentifizierte Benutzer, bevor auf die Ressource zugegriffen oder sie aufgerufen werden kann.

```yaml
Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -ComputerName

Gibt die URL oder den Hostnamen der Ziel-Instanz von PowerShell Universal an. Bloße Hostnamen werden in eine URL der Form http\://:5000 normalisiert.

```yaml
Type: String
Parameter Sets: (All)
Aliases: Uri

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -Cookies

Verwendet Authentifizierungs-Cookies für die aktuelle PowerShell-Sitzung erneut und speichert sie dauerhaft.

```yaml
Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -Credential

Gibt die Anmeldeinformationen an, die für die Basic-Authentifizierung an der PowerShell Universal-Verwaltungs-API verwendet werden.

```yaml
Type: PSCredential
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -Description

Gibt eine Beschreibung für die Ressource an.

```yaml
Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -Id

Gibt die numerische Id der Ressource an.

```yaml
Type: Int64
Parameter Sets: Id
Aliases:

Required: True
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -Integrated

Verwendet den prozessinternen integrierten Verwaltungsclient, wenn das Cmdlet innerhalb von PowerShell Universal ausgeführt wird.

```yaml
Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -Mcp

Stellt das KI-Tool über Model Context Protocol (MCP) bereit.

```yaml
Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -Name

Gibt den Namen der Ressource an.

```yaml
Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -Roles

Gibt eine oder mehrere Rollen an, die das KI-Tool aufrufen dürfen.

```yaml
Type: String[]
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -ScriptFullPath

Gibt den vollständigen Pfad zum PowerShell-Skript an, das das KI-Tool implementiert.

```yaml
Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -TrustCertificate

Erlaubt Verbindungen zu Servern mit nicht vertrauenswürdigen TLS-Zertifikaten.

```yaml
Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -UseDefaultCredentials

Verwendet die aktuellen Windows-Anmeldeinformationen bei der Authentifizierung an der Verwaltungs-API.

```yaml
Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### CommonParameters

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

## INPUTS

### PowerShellUniversal.Models.Intelligence.AiTool

## OUTPUTS

### System.Object

## NOTES

## RELATED LINKS


---

# 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/set-psuaitool.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.
