New-PSUAiTool

SYNOPSIS

Crée une nouvelle définition d'outil d'IA.

SYNTAXE

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

DESCRIPTION

Crée un nouvel outil d'IA reposant sur un script PowerShell et l'enregistre dans PowerShell Universal. Les agents d'IA peuvent ensuite invoquer l'outil directement ou par l'entremise de MCP lorsque celui-ci est activé.

EXEMPLES

Exemple 1

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

Crée un outil d'IA authentifié nommé GetTickets qui est exposé par l'entremise de MCP.

PARAMÈTRES

-AppToken

Spécifie le jeton d'appli à utiliser pour s'authentifier auprès de l'API de gestion PowerShell Universal.

Type: String
Parameter Sets: (All)
Aliases:

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

-Authenticated

Exige des utilisateurs authentifiés avant que la ressource puisse être consultée ou invoquée.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ComputerName

Spécifie l'URL ou le nom d'hôte de l'instance PowerShell Universal cible. Les noms d'hôte simples sont normalisés en une URL http://<host>:5000.

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

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

-Cookies

Réutilise et conserve les témoins d'authentification pour la session PowerShell en cours.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Credential

Spécifie les identifiants à utiliser pour l'authentification de base auprès de l'API de gestion PowerShell Universal.

Type: PSCredential
Parameter Sets: (All)
Aliases:

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

-Description

Spécifie une description pour la ressource.

Type: String
Parameter Sets: (All)
Aliases:

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

-Integrated

Utilise le client de gestion intégré en cours de processus lorsque l'applet de commande s'exécute dans PowerShell Universal.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Mcp

Expose l'outil d'IA par l'entremise du protocole Model Context Protocol (MCP).

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Name

Spécifie le nom de la ressource.

Type: String
Parameter Sets: (All)
Aliases:

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

-Role

Spécifie un ou plusieurs rôles à attribuer ou à autoriser.

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

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

-ScriptFullPath

Spécifie le chemin complet du script PowerShell qui implémente l'outil d'IA.

Type: String
Parameter Sets: (All)
Aliases:

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

-TrustCertificate

Permet les connexions aux serveurs dont les certificats TLS ne sont pas approuvés.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-UseDefaultCredentials

Utilise les identifiants Windows actuels pour s'authentifier auprès de l'API de gestion.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

CommonParameters

Cette applet de commande prend en charge les paramètres communs : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -Verbose, -WarningAction, -WarningVariable et -ProgressAction. Pour plus d'informations, consultez about_CommonParameters.

ENTRÉES

Aucune

SORTIES

System.Object

NOTES

LIENS CONNEXES

SYNOPSIS

Crée une définition d'outil d'IA reposant sur un script PowerShell.

SYNTAXE

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

DESCRIPTION

Crée un outil d'IA pour les agents ou MCP. -Environment sélectionne l'environnement d'exécution par défaut et -Computer sélectionne l'ordinateur ou le groupe d'ordinateurs cible par défaut. Utilisez un groupe sous la forme '<GroupName> (All)' ou '<GroupName> (Any)'.

-DefaultMaxWaitTimeoutSeconds définit le délai d'attente maximal par défaut pour les tâches de l'outil; il est de 30 secondes par défaut.

EXEMPLE

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

PARAMÈTRES

• Environment : Environnement d'exécution par défaut.
• Computer : Ordinateur ou groupe d'ordinateurs cible par défaut.
• DefaultMaxWaitTimeoutSeconds : Délai d'attente par défaut des tâches de l'outil, en secondes (30 par défaut).
• Mcp : Expose l'outil par l'entremise de MCP.