> 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/set-psuaitool.md). # Set-PSUAiTool Set-PSUAiTool actualiza una definición de herramienta de IA existente en PowerShell Universal, modificando sus metadatos, roles, ruta de script o exposición MCP. ## SINOPSIS Actualiza una definición de herramienta de IA existente. ## SINTAXIS ### Id ``` Set-PSUAiTool [-Id] [-Name ] [-Description ] [-Authenticated ] [-Roles ] [-ScriptFullPath ] [-Mcp] [-ComputerName ] [-AppToken ] [-Credential ] [-UseDefaultCredentials] [-Integrated] [-TrustCertificate] [-Cookies] [] ``` ### AiTool ``` Set-PSUAiTool [-AiTool] [-Name ] [-Description ] [-Authenticated ] [-Roles ] [-ScriptFullPath ] [-Mcp] [-ComputerName ] [-AppToken ] [-Credential ] [-UseDefaultCredentials] [-Integrated] [-TrustCertificate] [-Cookies] [] ``` ## DESCRIPCIÓN Carga una herramienta de IA por Id o por objeto de canalización y aplica únicamente los campos proporcionados al cmdlet. Utilice este cmdlet para modificar los metadatos, la autorización, las rutas de script o la exposición MCP. ## EJEMPLOS ### Ejemplo 1 ```powershell PS C:\> Set-PSUAiTool -Id 5 -Description "Ticket lookup and updates" -Authenticated $true -Roles HelpDesk,Admin -Mcp ``` Actualiza la herramienta de IA 5 con una nueva descripción, lista de roles y exposición MCP. ## PARÁMETROS ### -AiTool Especifica la herramienta de IA de destino. ```yaml Type: AiTool Parameter Sets: AiTool Aliases: Required: True Position: 0 Default value: None Accept pipeline input: True (ByValue) Accept wildcard characters: False ``` ### -AppToken Especifica el token de aplicación que se debe utilizar al autenticarse en la API de administració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 para poder acceder al recurso o invocarlo. ```yaml Type: Boolean 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 deben utilizar para la autenticación básica en la API de administració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 ``` ### -Id Especifica el Id numérico del recurso. ```yaml Type: Int64 Parameter Sets: Id Aliases: Required: True Position: 0 Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Integrated Utiliza el cliente de administración integrado en el 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: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Roles Especifica uno o varios roles con permiso para invocar la herramienta de IA. ```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: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -TrustCertificate Permite conexiones a servidores con certificados TLS no de confianza. ```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 administració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 ### PowerShellUniversal.Models.Intelligence.AiTool ## SALIDAS ### System.Object ## NOTAS ## ENLACES RELACIONADOS ## SINOPSIS Actualiza una definición de herramienta de IA existente. ## SINTAXIS ```powershell Set-PSUAiTool -Id [-Name ] [-Description ] [-Authenticated ] [-Roles ] [-ScriptFullPath ] [-DefaultMaxWaitTimeoutSeconds ] [-Environment ] [-Computer ] [-Mcp] Set-PSUAiTool -AiTool [-Name ] [-Description ] [-Authenticated ] [-Roles ] [-ScriptFullPath ] [-DefaultMaxWaitTimeoutSeconds ] [-Environment ] [-Computer ] [-Mcp] ``` ## DESCRIPCIÓN Actualiza únicamente los campos proporcionados. `-Environment` y `-Computer` establecen el destino de ejecución predeterminado de la herramienta; los grupos de equipos admiten `' (All)'` y `' (Any)'`. `-DefaultMaxWaitTimeoutSeconds` establece el tiempo de espera predeterminado del trabajo de la herramienta; omítalo para conservar el valor actual. ## EJEMPLO ```powershell Set-PSUAiTool -Id 5 -Environment '7.4' -Computer 'Agents (Any)' -DefaultMaxWaitTimeoutSeconds 60 ``` --- # 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/set-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.