New-PSUAiTool

SINOPSIS

Crea una nueva definición de herramienta de IA.

SINTAXIS

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

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

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 debe usar al autenticarse en la API de gestión de PowerShell Universal.

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.

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://<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

Reutiliza y conserva las cookies de autenticación para la sesión actual de PowerShell.

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 usar para la autenticación básica en la API de gestión de PowerShell Universal.

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.

Type: String
Parameter Sets: (All)
Aliases:

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

-Integrated

Usa el cliente de gestión integrado en proceso cuando el cmdlet se ejecuta dentro de PowerShell Universal.

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).

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.

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 deben asignar o permitir.

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.

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 de confianza.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-UseDefaultCredentials

Usa las credenciales actuales de Windows al autenticarse en la API de gestión.

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 más información, consulte about_CommonParameters.