New-PSUAiTool

ÜBERSICHT

Erstellt eine neue KI-Tool-Definition.

SYNTAX

New-PSUAiTool [-Name] <String> [-Description <String>] [-Authenticated] [-Role <String[]>]
 -ScriptFullPath <String> [-Mcp] [-ComputerName <String>] [-AppToken <String>] [-Credential <PSCredential>]
 [-UseDefaultCredentials] [-Integrated] [-TrustCertificate] [-Cookies]
 [<CommonParameters>]

BESCHREIBUNG

Erstellt ein neues KI-Tool, das auf einem PowerShell-Skript basiert, und speichert es in PowerShell Universal. KI-Agenten können das Tool dann direkt oder, wenn aktiviert, über MCP aufrufen.

BEISPIELE

Beispiel 1

PS C:\> New-PSUAiTool -Name GetTickets -Description "Query ticket data" -ScriptFullPath "C:\\ProgramData\\UniversalAutomation\\Repository\\scripts\\GetTickets.ps1" -Authenticated -Role HelpDesk,Admin -Mcp

Erstellt ein authentifiziertes KI-Tool namens GetTickets, das über MCP bereitgestellt wird.

PARAMETER

-AppToken

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

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.

Type: SwitchParameter
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. Reine Hostnamen werden zu einer http://<host>:5000-URL normalisiert.

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.

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 gegenüber der PowerShell Universal-Verwaltungs-API verwendet werden.

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.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
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.

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 das Model Context Protocol (MCP) bereit.

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.

Type: String
Parameter Sets: (All)
Aliases:

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

-Role

Gibt eine oder mehrere Rollen an, die zugewiesen oder zugelassen werden.

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.

Type: String
Parameter Sets: (All)
Aliases:

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

-TrustCertificate

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

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 gegenüber der Verwaltungs-API.

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.

EINGABEN

Keine

AUSGABEN

System.Object

HINWEISE

VERWANDTE LINKS

ÜBERSICHT

Erstellt eine KI-Tool-Definition, die auf einem PowerShell-Skript basiert.

SYNTAX

New-PSUAiTool -Name <String> -ScriptFullPath <String> [-Description <String>] [-Authenticated] [-Role <String[]>] [-Mcp] [-DefaultMaxWaitTimeoutSeconds <Int32>] [-Environment <String>] [-Computer <String>]

BESCHREIBUNG

Erstellt ein KI-Tool für Agenten oder MCP. -Environment wählt die Standard-Ausführungsumgebung und -Computer wählt den Standardcomputer oder das Ziel einer Computergruppe aus. Verwenden Sie eine Gruppe in der Form '<GroupName> (All)' oder '<GroupName> (Any)'.

-DefaultMaxWaitTimeoutSeconds legt die maximale Standardwartezeit für Tool-Jobs fest; der Standardwert beträgt 30 Sekunden.

BEISPIEL

New-PSUAiTool -Name GetTickets -ScriptFullPath 'C:\Repository\GetTickets.ps1' -Environment '7.4' -Computer 'Agents (Any)' -DefaultMaxWaitTimeoutSeconds 60 -Mcp

PARAMETER

• Environment: Standard-Ausführungsumgebung.
• Computer: Standardcomputer oder Ziel einer Computergruppe.
• DefaultMaxWaitTimeoutSeconds: Standardwartezeit für Tool-Jobs in Sekunden (standardmäßig 30).
• Mcp: Stellt das Tool über MCP bereit.