> 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/es/comandos-de-powershell/new-psuaitool.md). # New-PSUAiTool New-PSUAiTool registra una nueva herramienta de IA respaldada por un script de PowerShell en PowerShell Universal y, opcionalmente, la expone a través de MCP. ## SINOPSIS Crea una nueva definición de herramienta de IA. ## SINTAXIS ``` New-PSUAiTool [-Name] [-Description ] [-Authenticated] [-Role ] -ScriptFullPath [-Mcp] [-ComputerName ] [-AppToken ] [-Credential ] [-UseDefaultCredentials] [-Integrated] [-TrustCertificate] [-Cookies] [] ``` ## DESCRIPCIÓN Crea una nueva herramienta de IA respaldada por un script de PowerShell y la almacena en PowerShell Universal. Los agentes de IA pueden entonces invocar la herramienta directamente o a través de MCP cuando está habilitado. ## EJEMPLOS ### Ejemplo 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 ``` Crea una herramienta de IA autenticada llamada GetTickets que se expone a través de MCP. ## PARÁMETROS ### -AppToken Especifica el token de aplicación que se utilizará al autenticarse en la API de gestión de 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 Requiere usuarios autenticados antes de que se pueda acceder al recurso o invocarlo. ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -ComputerName Especifica la URL o el nombre de host de la instancia de PowerShell Universal de destino. Los nombres de host simples se normalizan a una 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 Reutiliza y conserva las cookies de autenticación para la sesión actual de PowerShell. ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Credential Especifica las credenciales que se utilizarán para la autenticación básica contra la API de gestión de 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 Especifica una descripción para el recurso. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Integrated Utiliza el cliente de gestión integrado en proceso cuando el cmdlet se ejecuta dentro de 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 Expone la herramienta de IA a través de 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 Especifica el nombre del recurso. ```yaml Type: String Parameter Sets: (All) Aliases: Required: True Position: 0 Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Role Especifica uno o varios roles que se asignarán o permitirán. ```yaml Type: String[] Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -ScriptFullPath Especifica la ruta completa al script de PowerShell que implementa la herramienta de IA. ```yaml Type: String Parameter Sets: (All) Aliases: Required: True Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -TrustCertificate Permite conexiones a servidores con certificados TLS no confiables. ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -UseDefaultCredentials Utiliza las credenciales actuales de Windows al autenticarse en la API de gestión. ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### CommonParameters Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -Verbose, -WarningAction, -WarningVariable y -ProgressAction. Para obtener más información, consulte [about\_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). ## ENTRADAS ### Ninguna ## SALIDAS ### System.Object ## NOTAS ## ENLACES RELACIONADOS ## SINOPSIS Crea una definición de herramienta de IA respaldada por un script de PowerShell. ## SINTAXIS ```powershell New-PSUAiTool -Name -ScriptFullPath [-Description ] [-Authenticated] [-Role ] [-Mcp] [-DefaultMaxWaitTimeoutSeconds ] [-Environment ] [-Computer ] ``` ## DESCRIPCIÓN Crea una herramienta de IA para agentes o MCP. `-Environment` selecciona el entorno de ejecución predeterminado y `-Computer` selecciona el equipo o grupo de equipos de destino predeterminado. Utilice un grupo con el formato `' (All)'` o `' (Any)'`. `-DefaultMaxWaitTimeoutSeconds` establece el tiempo máximo de espera predeterminado para los trabajos de la herramienta; su valor predeterminado es de 30 segundos. ## EJEMPLO ```powershell New-PSUAiTool -Name GetTickets -ScriptFullPath 'C:\Repository\GetTickets.ps1' -Environment '7.4' -Computer 'Agents (Any)' -DefaultMaxWaitTimeoutSeconds 60 -Mcp ``` ## PARÁMETROS * **Environment**: entorno de ejecución predeterminado. * **Computer**: equipo o grupo de equipos de destino predeterminado. * **DefaultMaxWaitTimeoutSeconds**: tiempo de espera predeterminado del trabajo de la herramienta en segundos (30 de forma predeterminada). * **Mcp**: expone la herramienta a través 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/es/comandos-de-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.