New-PSUAiTool

SINOSSI

Crea una nuova definizione di strumento IA.

SINTASSI

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

DESCRIZIONE

Crea un nuovo strumento IA basato su uno script PowerShell e lo archivia in PowerShell Universal. Gli agenti IA possono quindi richiamare lo strumento direttamente o tramite MCP, se abilitato.

ESEMPI

Esempio 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 uno strumento IA autenticato denominato GetTickets esposto tramite MCP.

PARAMETRI

-AppToken

Specifica il token dell'app da utilizzare per l'autenticazione all'API di gestione di PowerShell Universal.

Type: String
Parameter Sets: (All)
Aliases:

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

-Authenticated

Richiede utenti autenticati prima che sia possibile accedere alla risorsa o richiamarla.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ComputerName

Specifica l'URL o il nome host dell'istanza di PowerShell Universal di destinazione. I nomi host semplici vengono normalizzati in un 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

Riutilizza e mantiene i cookie di autenticazione per la sessione PowerShell corrente.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Credential

Specifica le credenziali da utilizzare per l'autenticazione di base verso l'API di gestione di PowerShell Universal.

Type: PSCredential
Parameter Sets: (All)
Aliases:

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

-Description

Specifica una descrizione per la risorsa.

Type: String
Parameter Sets: (All)
Aliases:

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

-Integrated

Utilizza il client di gestione integrato in-process quando il cmdlet viene eseguito all'interno di PowerShell Universal.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Mcp

Espone lo strumento IA tramite 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

Specifica il nome della risorsa.

Type: String
Parameter Sets: (All)
Aliases:

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

-Role

Specifica uno o più ruoli da assegnare o consentire.

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

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

-ScriptFullPath

Specifica il percorso completo dello script PowerShell che implementa lo strumento IA.

Type: String
Parameter Sets: (All)
Aliases:

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

-TrustCertificate

Consente connessioni a server con certificati TLS non attendibili.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-UseDefaultCredentials

Utilizza le credenziali Windows correnti durante l'autenticazione all'API di gestione.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -Verbose, -WarningAction, -WarningVariable e -ProgressAction. Per maggiori informazioni, veda about_CommonParameters.