> 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/fr/commandes-powershell/new-psuapp.md). # New-PSUApp New-PSUApp crée une nouvelle appli dans PowerShell Universal à partir d'un chemin de fichier, du contenu d'un script ou d'un module, avec des options d'authentification et de rôles. ## SYNOPSIS Crée une nouvelle appli dans PowerShell Universal. ## SYNTAXE ### FilePath (par défaut) ``` New-PSUApp [-FilePath ] [-BaseUrl ] -Name [-Environment ] [-GrantAppToken] [-Maintenance] [-Authenticated] [-Role ] [-DisableAutoStart] [-Component ] [-SessionTimeout ] [-IdleTimeout ] [-AutoDeploy] [-Description ] [-Credential ] [-DisableErrorToast] [-DisableStartupLog] [-VerboseErrorMessages] [-Tag ] [-DisableInteractiveHost] [-FavIcon ] [-OnSessionTimeout ] [-ComputerGroup ] [-AvailableInBranch ] [-Critical] [-ComputerName ] [-AppToken ] [-UseDefaultCredentials] [-Integrated] [-TrustCertificate] [-Cookies] [] ``` ### Content ``` New-PSUApp -Content [-BaseUrl ] -Name [-Environment ] [-GrantAppToken] [-Maintenance] [-Authenticated] [-Role ] [-DisableAutoStart] [-Component ] [-SessionTimeout ] [-IdleTimeout ] [-AutoDeploy] [-Description ] [-Credential ] [-DisableErrorToast] [-DisableStartupLog] [-VerboseErrorMessages] [-Tag ] [-DisableInteractiveHost] [-FavIcon ] [-OnSessionTimeout ] [-ComputerGroup ] [-AvailableInBranch ] [-Critical] [-ComputerName ] [-AppToken ] [-UseDefaultCredentials] [-Integrated] [-TrustCertificate] [-Cookies] [] ``` ### Module ``` New-PSUApp [-BaseUrl ] -Name [-Environment ] [-GrantAppToken] [-Maintenance] [-Authenticated] [-Role ] [-DisableAutoStart] [-Component ] [-SessionTimeout ] [-IdleTimeout ] [-AutoDeploy] [-Description ] [-Credential ] [-DisableErrorToast] [-DisableStartupLog] [-VerboseErrorMessages] [-Tag ] [-DisableInteractiveHost] [-Module ] [-Command ] [-FavIcon ] [-OnSessionTimeout ] [-ComputerGroup ] [-AvailableInBranch ] [-Critical] [-ComputerName ] [-AppToken ] [-UseDefaultCredentials] [-Integrated] [-TrustCertificate] [-Cookies] [] ``` ## DESCRIPTION Crée une nouvelle appli dans PowerShell Universal. ## EXEMPLES ### Exemple 1 ```powershell New-PSUApp -Name 'App' -BaseUrl '/app' -FilePath "app.ps1" ``` Crée une appli en utilisant le fichier app.ps1 dans le répertoire du dépôt et la sert à l'URL de base /app. ## PARAMÈTRES ### -AppToken Le AppToken utilisé pour appeler l'API de gestion de PowerShell Universal. Vous pouvez aussi appeler Connect-PSUServer avant d'appeler cette applet de commande pour définir le AppToken pour toute la session. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Authenticated Lorsque spécifié, l'authentification est activée pour cette appli. ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -AutoDeploy Indique s'il faut déployer cette appli lorsque des changements sont apportés. Si non spécifié, l'appli doit être redémarrée avant que les changements soient appliqués. ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -BaseUrl L'URL de base pour accéder à cette appli. Vous pouvez utiliser / pour servir l'appli à la racine du serveur ou /app pour servir l'appli à /app. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Command La commande utilisée pour créer cette appli. ```yaml Type: String Parameter Sets: Module Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Component Non utilisé. Présent uniquement pour la rétrocompatibilité. ```yaml Type: DashboardComponent[] Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -ComputerName Spécifie le nom de l'ordinateur ou l'URL qui doit être appelé lors de l'accès à l'API de gestion de PowerShell Universal. Vous pouvez aussi utiliser Connect-PSUServer avant d'appeler cette applet de commande pour définir le nom de l'ordinateur pour toute la session. ```yaml Type: String Parameter Sets: (All) Aliases: Uri Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Content Le contenu de cette appli. ```yaml Type: ScriptBlock Parameter Sets: Content Aliases: Required: True Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Credential L'identifiant utilisateur sous lequel exécuter cette appli. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Description Une description de cette appli. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -DisableAutoStart Indique s'il faut désactiver le démarrage automatique de cette appli au démarrage du serveur. ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -DisableErrorToast Indique s'il faut désactiver les notifications toast d'erreur pour cette appli. ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -DisableInteractiveHost Indique s'il faut désactiver l'hôte interactif pour cette appli. Write-Host, Read-Host, Get-Credential et d'autres fonctionnalités ne fonctionneront plus. ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -DisableStartupLog Indique s'il faut désactiver le journal de démarrage pour cette appli. ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Environment L'environnement sous lequel exécuter cette appli. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -FavIcon L'URL de la favicône pour cette appli. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -FilePath Le chemin vers le fichier qui contient le contenu de cette appli. ```yaml Type: String Parameter Sets: FilePath Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -GrantAppToken Indique s'il faut accorder un jeton d'appli aux utilisateurs de cette appli. Vous pouvez utiliser le jeton d'appli dans votre appli pour accéder aux ressources de PSU en tant qu'utilisateur qui se connecte. ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -IdleTimeout Le délai d'inactivité pour cette appli. ```yaml Type: Int32 Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Integrated Exécute la commande en interne plutôt que d'utiliser l'API de gestion. Fonctionne uniquement lors de l'exécution d'un script à partir 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 ``` ### -Maintenance Indique s'il faut mettre cette appli en mode maintenance. Seuls les administrateurs pourront accéder à l'appli lorsqu'elle est en mode maintenance. ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Module Le module qui contient la commande utilisée pour définir cette appli. ```yaml Type: String Parameter Sets: Module Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Name Le nom de cette appli. ```yaml Type: String Parameter Sets: (All) Aliases: Required: True Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Role Rôles ayant accès à cette appli. ```yaml Type: String[] Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -SessionTimeout Le délai d'expiration de session pour cette appli. ```yaml Type: Int32 Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Tag Étiquettes à appliquer à cette appli. ```yaml Type: Tag[] Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -UseDefaultCredentials Utiliser les identifiants par défaut lors de la connexion à l'API de gestion ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -VerboseErrorMessages Indique s'il faut afficher des messages d'erreur détaillés pour cette appli. ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -ComputerGroup Spécifie le groupe d'ordinateurs à cibler ou à assigner. ```yaml Type: String[] Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -OnSessionTimeout Spécifie le bloc de script à exécuter lorsqu'une session d'appli expire. ```yaml Type: ScriptBlock Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -AvailableInBranch Lorsque spécifié, cette appli sera affichée et exécutée uniquement dans les branches spécifiées. ```yaml Type: String[] Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -TrustCertificate Indique si l'applet de commande doit ignorer les problèmes de certificat. ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Critical L'appli est critique. Cela fera en sorte que le terminal /api/v1/status retourne un 500 si l'appli n'a pas démarré. ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Cookies Réutilise et conserve les témoins d'authentification pour la session PowerShell actuelle. ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### CommonParameters Cette applet de commande prend en charge les paramètres communs : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -Verbose, -WarningAction, -WarningVariable et -ProgressAction. Pour plus d'informations, voir [about\_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). ## ENTRÉES ### Aucune ## SORTIES ### System.Object ## NOTES ## LIENS CONNEXES --- # 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/fr/commandes-powershell/new-psuapp.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.