New-PSUApp
SYNOPSIS
Crée une nouvelle appli dans PowerShell Universal.
SYNTAXE
FilePath (par défaut)
New-PSUApp [-FilePath <String>] [-BaseUrl <String>] -Name <String> [-Environment <String>] [-GrantAppToken]
[-Maintenance] [-Authenticated] [-Role <String[]>] [-DisableAutoStart] [-Component <DashboardComponent[]>]
[-SessionTimeout <Int32>] [-IdleTimeout <Int32>] [-AutoDeploy] [-Description <String>] [-Credential <String>]
[-DisableErrorToast] [-DisableStartupLog] [-VerboseErrorMessages] [-Tag <Tag[]>] [-DisableInteractiveHost]
[-FavIcon <String>] [-OnSessionTimeout <ScriptBlock>] [-ComputerGroup <String[]>]
[-AvailableInBranch <String[]>] [-Critical] [-ComputerName <String>] [-AppToken <String>]
[-UseDefaultCredentials] [-Integrated] [-TrustCertificate] [-Cookies]
[<CommonParameters>]Content
New-PSUApp -Content <ScriptBlock> [-BaseUrl <String>] -Name <String> [-Environment <String>] [-GrantAppToken]
[-Maintenance] [-Authenticated] [-Role <String[]>] [-DisableAutoStart] [-Component <DashboardComponent[]>]
[-SessionTimeout <Int32>] [-IdleTimeout <Int32>] [-AutoDeploy] [-Description <String>] [-Credential <String>]
[-DisableErrorToast] [-DisableStartupLog] [-VerboseErrorMessages] [-Tag <Tag[]>] [-DisableInteractiveHost]
[-FavIcon <String>] [-OnSessionTimeout <ScriptBlock>] [-ComputerGroup <String[]>]
[-AvailableInBranch <String[]>] [-Critical] [-ComputerName <String>] [-AppToken <String>]
[-UseDefaultCredentials] [-Integrated] [-TrustCertificate] [-Cookies]
[<CommonParameters>]Module
DESCRIPTION
Crée une nouvelle appli dans PowerShell Universal.
EXEMPLES
Exemple 1
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.
-Authenticated
Lorsque spécifié, l'authentification est activée pour cette appli.
-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.
-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.
-Command
La commande utilisée pour créer cette appli.
-Component
Non utilisé. Présent uniquement pour la rétrocompatibilité.
-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.
-Content
Le contenu de cette appli.
-Credential
L'identifiant utilisateur sous lequel exécuter cette appli.
-Description
Une description de cette appli.
-DisableAutoStart
Indique s'il faut désactiver le démarrage automatique de cette appli au démarrage du serveur.
-DisableErrorToast
Indique s'il faut désactiver les notifications toast d'erreur pour cette appli.
-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.
-DisableStartupLog
Indique s'il faut désactiver le journal de démarrage pour cette appli.
-Environment
L'environnement sous lequel exécuter cette appli.
-FavIcon
L'URL de la favicône pour cette appli.
-FilePath
Le chemin vers le fichier qui contient le contenu de cette appli.
-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.
-IdleTimeout
Le délai d'inactivité pour cette appli.
-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.
-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.
-Module
Le module qui contient la commande utilisée pour définir cette appli.
-Name
Le nom de cette appli.
-Role
Rôles ayant accès à cette appli.
-SessionTimeout
Le délai d'expiration de session pour cette appli.
-Tag
Étiquettes à appliquer à cette appli.
-UseDefaultCredentials
Utiliser les identifiants par défaut lors de la connexion à l'API de gestion
-VerboseErrorMessages
Indique s'il faut afficher des messages d'erreur détaillés pour cette appli.
-ComputerGroup
Spécifie le groupe d'ordinateurs à cibler ou à assigner.
-OnSessionTimeout
Spécifie le bloc de script à exécuter lorsqu'une session d'appli expire.
-AvailableInBranch
Lorsque spécifié, cette appli sera affichée et exécutée uniquement dans les branches spécifiées.
-TrustCertificate
Indique si l'applet de commande doit ignorer les problèmes de certificat.
-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é.
-Cookies
Réutilise et conserve les témoins d'authentification pour la session PowerShell actuelle.
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.
ENTRÉES
Aucune
SORTIES
System.Object
NOTES
LIENS CONNEXES
Mis à jour
Ce contenu vous a-t-il été utile ?