Applications statiques

Créez des applications web statiques avec PowerShell Universal.

Les applications PowerShell Universal statiques ne nécessitent pas l'exécution du serveur PowerShell Universal. Elles peuvent être hébergées sur des serveurs web simples comme Azure Blobs ou dans IIS directement depuis le système de fichiers. Elles sont constituées du framework JavaScript d'application PowerShell Universal et d'une série de fichiers JSON créés lors du processus de publication. Les applications statiques ne prennent pas en charge les fonctionnalités interactives de PowerShell Universal. Elles prennent en charge l'exécution de JavaScript.

Création d'une application statique

Le cmdlet Publish-PSUStaticApp est responsable de la création d'une application. Vous pouvez utiliser les cmdlets d'application standard dans la définition. Par exemple, ce qui suit créerait une application dans le dossier de sortie avec un seul composant UDRating.

Publish-PSUStaticApp -Definition { 
    New-UDApp -Content { 
       New-UDRating -Max 10 
    } 
} -DestinationPath .\output -Force 

Vous pouvez également intégrer des appels JavaScript dans votre application partout où un point de terminaison peut être utilisé. Par exemple, dans le paramètre -OnChange de New-UDRating. La variable data contiendra les données de l'événement.

Publish-PSUStaticApp -Definition {
   New-UDApp -Content {
      New-UDRating -Max 10 -OnChange (New-UDEndpoint -JavaScript 'alert(data)') 
   } 
} -DestinationPath .\output -Force 

Publication d'une application statique

Les applications statiques peuvent être publiées sur n'importe quel serveur web capable de servir des fichiers HTML, JavaScript et CSS. Vous devez publier l'intégralité du contenu du dossier de sortie pour que l'application fonctionne.

Limitations

Aucune interaction avec l'application

Vous ne pouvez pas utiliser les fonctionnalités interactives des applications PowerShell Universal, à l'exception de JavaScript. Cela inclut, sans s'y limiter :

• Modales et notifications toast
• Cmdlets -UDElement
• Fournisseurs de données comme $Cache et $Session

Aucune interaction avec l'hôte PowerShell

Lors de la création de l'application, tous les blocs de script dans l'application s'exécutent immédiatement, plutôt que sur demande comme lorsqu'ils sont hébergés dans PowerShell Universal. Cela signifie que des commandes telles que Write-Host et Write-Error s'exécuteront pendant la création et non lorsque l'application fonctionne dans le navigateur. Les éléments suivants s'exécuteront également immédiatement :

• Read-Host
• PromptForChoice
• Get-Credential

Prise en charge limitée des contrôles

Bien qu'il soit possible d'utiliser n'importe quel contrôle et de spécifier le JavaScript pour son interaction, cela n'est pas recommandé en raison de la complexité. Les contrôles à éviter incluent :

• Data Grid
• Dynamic Region
• Protect Section