> 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/fr/commandes-powershell/new-psuaitool.md). # New-PSUAiTool New-PSUAiTool enregistre un nouvel outil d'IA reposant sur un script PowerShell dans PowerShell Universal, en l'exposant optionnellement par l'entremise de MCP. ## SYNOPSIS Crée une nouvelle définition d'outil d'IA. ## SYNTAXE ``` New-PSUAiTool [-Name] [-Description ] [-Authenticated] [-Role ] -ScriptFullPath [-Mcp] [-ComputerName ] [-AppToken ] [-Credential ] [-UseDefaultCredentials] [-Integrated] [-TrustCertificate] [-Cookies] [] ``` ## 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 ```powershell 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. ```yaml 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. ```yaml 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://:5000`. ```yaml 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. ```yaml 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. ```yaml 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. ```yaml 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. ```yaml 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). ```yaml 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. ```yaml 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. ```yaml 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. ```yaml 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. ```yaml 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. ```yaml 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](http://go.microsoft.com/fwlink/?LinkID=113216). ## 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 ```powershell New-PSUAiTool -Name -ScriptFullPath [-Description ] [-Authenticated] [-Role ] [-Mcp] [-DefaultMaxWaitTimeoutSeconds ] [-Environment ] [-Computer ] ``` ## 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 `' (All)'` ou `' (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 ```powershell 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. --- # 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/fr/commandes-powershell/new-psuaitool.md?ask=&goal= ``` `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.