> 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/it/comandi-powershell/new-psudashboard.md). # New-PSUDashboard New-PSUDashboard crea una nuova app in PowerShell Universal a partire da un percorso di file, dal contenuto di uno script o da un modulo, utilizzando il nome legacy del cmdlet dashboard. ### Sinossi Crea una nuova app in PowerShell Universal. ### Sintassi ```powershell New-PSUDashboard [-AppToken ] [-Authenticated] [-AutoDeploy] [-BaseUrl ] [-Command ] [-Component ] [-ComputerName ] [-Credential ] [-Description ] [-DisableAutoStart] [-DisableErrorToast] [-DisableInteractiveHost] [-DisableStartupLog] [-Environment ] [-FavIcon ] [-GrantAppToken] [-IdleTimeout ] [-Integrated] [-Maintenance] [-Module ] -Name [-Role ] [-SessionTimeout ] [-Tag ] [-UseDefaultCredentials] [-VerboseErrorMessages] [-ComputerGroup ] [-OnSessionTimeout ] [-AvailableInBranch ] [-TrustCertificate] [-Critical] [] New-PSUDashboard [-AppToken ] [-Authenticated] [-AutoDeploy] [-BaseUrl ] [-Component ] [-ComputerName ] -Content [-Credential ] [-Description ] [-DisableAutoStart] [-DisableErrorToast] [-DisableInteractiveHost] [-DisableStartupLog] [-Environment ] [-FavIcon ] [-GrantAppToken] [-IdleTimeout ] [-Integrated] [-Maintenance] -Name [-Role ] [-SessionTimeout ] [-Tag ] [-UseDefaultCredentials] [-VerboseErrorMessages] [-ComputerGroup ] [-OnSessionTimeout ] [-AvailableInBranch ] [-TrustCertificate] [-Critical] [] New-PSUDashboard [-AppToken ] [-Authenticated] [-AutoDeploy] [-BaseUrl ] [-Component ] [-ComputerName ] [-Credential ] [-Description ] [-DisableAutoStart] [-DisableErrorToast] [-DisableInteractiveHost] [-DisableStartupLog] [-Environment ] [-FavIcon ] [-FilePath ] [-GrantAppToken] [-IdleTimeout ] [-Integrated] [-Maintenance] -Name [-Role ] [-SessionTimeout ] [-Tag ] [-UseDefaultCredentials] [-VerboseErrorMessages] [-ComputerGroup ] [-OnSessionTimeout ] [-AvailableInBranch ] [-TrustCertificate] [-Critical] [] ``` ### Descrizione Crea una nuova app in PowerShell Universal. ### Parametri #### -AppToken L'AppToken utilizzato per chiamare la Management API di PowerShell Universal. È anche possibile chiamare Connect-PSUServer prima di questo cmdlet per impostare l'AppToken per l'intera sessione. ``` Required? false Position? named Default value None Accept pipeline input? False Aliases none Accept wildcard characters? false ``` #### -Authenticated Se specificato, l'autenticazione è abilitata per questa app. ``` Required? false Position? named Default value False Accept pipeline input? False Aliases none Accept wildcard characters? false ``` #### -AutoDeploy Indica se distribuire questa app quando vengono apportate modifiche. Se non specificato, l'app deve essere riavviata prima che le modifiche vengano applicate. ``` Required? false Position? named Default value False Accept pipeline input? False Aliases none Accept wildcard characters? false ``` #### -BaseUrl L'URL di base per accedere a questa app. È possibile utilizzare / per servire l'app nella radice del server oppure /app per servirla in /app. ``` Required? false Position? named Default value None Accept pipeline input? False Aliases none Accept wildcard characters? false ``` #### -Command Il comando utilizzato per creare questa app. ``` Required? false Position? named Default value None Accept pipeline input? False Aliases none Accept wildcard characters? false ``` #### -Component \ Non utilizzato. Presente solo per compatibilità con le versioni precedenti. ``` Required? false Position? named Default value None Accept pipeline input? False Aliases none Accept wildcard characters? false ``` #### -ComputerName Specifica il nome del computer o l'URL da chiamare quando si accede alla Management API di PowerShell Universal. È anche possibile utilizzare Connect-PSUServer prima di questo cmdlet per impostare il nome del computer per l'intera sessione. ``` Required? false Position? named Default value None Accept pipeline input? False Aliases Uri Accept wildcard characters? false ``` #### -Content Il contenuto di questa app. ``` Required? true Position? named Default value None Accept pipeline input? False Aliases none Accept wildcard characters? false ``` #### -Credential Le credenziali utente con cui eseguire questa app. ``` Required? false Position? named Default value None Accept pipeline input? False Aliases none Accept wildcard characters? false ``` #### -Description Una descrizione di questa app. ``` Required? false Position? named Default value None Accept pipeline input? False Aliases none Accept wildcard characters? false ``` #### -DisableAutoStart Indica se disabilitare l'avvio automatico di questa app all'avvio del server. ``` Required? false Position? named Default value False Accept pipeline input? False Aliases none Accept wildcard characters? false ``` #### -DisableErrorToast Indica se disabilitare i toast di errore per questa app. ``` Required? false Position? named Default value False Accept pipeline input? False Aliases none Accept wildcard characters? false ``` #### -DisableInteractiveHost Indica se disabilitare l'host interattivo per questa app. Write-Host, Read-Host, Get-Credential e altre funzionalità non funzioneranno più. ``` Required? false Position? named Default value False Accept pipeline input? False Aliases none Accept wildcard characters? false ``` #### -DisableStartupLog Indica se disabilitare il log di avvio per questa app. ``` Required? false Position? named Default value False Accept pipeline input? False Aliases none Accept wildcard characters? false ``` #### -Environment L'ambiente in cui eseguire questa app. ``` Required? false Position? named Default value None Accept pipeline input? False Aliases none Accept wildcard characters? false ``` #### -FavIcon L'URL della favicon per questa app. ``` Required? false Position? named Default value None Accept pipeline input? False Aliases none Accept wildcard characters? false ``` #### -FilePath Il percorso del file che contiene il contenuto di questa app. ``` Required? false Position? named Default value None Accept pipeline input? False Aliases none Accept wildcard characters? false ``` #### -GrantAppToken Indica se concedere un token app agli utenti di questa app. È possibile utilizzare il token app all'interno dell'app per accedere alle risorse di PSU come l'utente che effettua l'accesso. ``` Required? false Position? named Default value False Accept pipeline input? False Aliases none Accept wildcard characters? false ``` #### -IdleTimeout Il timeout di inattività per questa app. ``` Required? false Position? named Default value None Accept pipeline input? False Aliases none Accept wildcard characters? false ``` #### -Integrated Esegue il comando internamente anziché utilizzare la Management API. Funziona solo quando lo script viene eseguito all'interno di PowerShell Universal. ``` Required? false Position? named Default value False Accept pipeline input? False Aliases none Accept wildcard characters? false ``` #### -Maintenance Indica se mettere questa app in modalità di manutenzione. Solo gli amministratori potranno accedere all'app quando è in modalità di manutenzione. ``` Required? false Position? named Default value False Accept pipeline input? False Aliases none Accept wildcard characters? false ``` #### -Module Il modulo che contiene il comando utilizzato per definire questa app. ``` Required? false Position? named Default value None Accept pipeline input? False Aliases none Accept wildcard characters? false ``` #### -Name Il nome di questa app. ``` Required? true Position? named Default value None Accept pipeline input? False Aliases none Accept wildcard characters? false ``` #### -Role \ Ruoli che hanno accesso a questa app. ``` Required? false Position? named Default value None Accept pipeline input? False Aliases none Accept wildcard characters? false ``` #### -SessionTimeout Il timeout di sessione per questa app. ``` Required? false Position? named Default value None Accept pipeline input? False Aliases none Accept wildcard characters? false ``` #### -Tag \ Tag da applicare a questa app. ``` Required? false Position? named Default value None Accept pipeline input? False Aliases none Accept wildcard characters? false ``` #### -UseDefaultCredentials Utilizza le credenziali predefinite durante la connessione alla Management API ``` Required? false Position? named Default value False Accept pipeline input? False Aliases none Accept wildcard characters? false ``` #### -VerboseErrorMessages Indica se visualizzare messaggi di errore dettagliati per questa app. ``` Required? false Position? named Default value False Accept pipeline input? False Aliases none Accept wildcard characters? false ``` #### -ComputerGroup \ {{ Fill ComputerGroup Description }} ``` Required? false Position? named Default value None Accept pipeline input? False Aliases none Accept wildcard characters? false ``` #### -OnSessionTimeout {{ Fill OnSessionTimeout Description }} ``` Required? false Position? named Default value None Accept pipeline input? False Aliases none Accept wildcard characters? false ``` #### -AvailableInBranch \ Se specificato, questa app verrà visualizzata ed eseguita solo nei branch specificati. ``` Required? false Position? named Default value None Accept pipeline input? False Aliases none Accept wildcard characters? false ``` #### -TrustCertificate Indica se il cmdlet deve ignorare i problemi relativi ai certificati. ``` Required? false Position? named Default value False Accept pipeline input? False Aliases none Accept wildcard characters? false ``` #### -Critical L'app è critica. Questo farà sì che l'endpoint /api/v1/status restituisca un errore 500 se l'app non è stata avviata. ``` Required? false Position? named Default value False Accept pipeline input? False Aliases none Accept wildcard characters? false ``` #### Parametri comuni Questo cmdlet supporta i parametri comuni: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, PipelineVariable e OutVariable. Per maggiori informazioni, veda [about\_CommonParameters](https://go.microsoft.com/fwlink/?LinkID=113216). ### Input Nessuno ### Output System.Object ### Note ### Esempi #### Esempio 1 ```powershell New-PSUDashboard -Name 'App' -BaseUrl '/app' -FilePath "app.ps1" ``` Crea un'app utilizzando il file app.ps1 nella directory del repository e la serve all'URL di base /app. --- # 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/it/comandi-powershell/new-psudashboard.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.