Référentiel
Informations sur le référentiel PowerShell Universal.
Les données de configuration de PowerShell Universal sont principalement stockées dans le référentiel. Par défaut, le dossier du référentiel se trouve dans %ProgramData%\UniversalAutomation\Repository. Vous pouvez modifier l'emplacement du référentiel en modifiant le fichier appsettings.json.
Le référentiel contient des scripts PowerShell et des fichiers XML produits lors de l'utilisation de la console d'administration de PowerShell Universal. Le dossier du référentiel est également surveillé pour détecter les modifications, de sorte que toute modification effectuée sur le disque entraîne le rechargement du fichier et la reconfiguration de la plateforme par le système. Lors de l'utilisation de l'intégration Git, le dossier du référentiel est celui qui est synchronisé avec le dépôt distant Git.
Toutes les applets de commande de configuration font partie du module Universal.
Ce qui est stocké dans le référentiel
Les fichiers stockés dans le référentiel sont enregistrés en texte brut pour faciliter la comparaison avec les outils de contrôle de source.
Authentification
Agents et outils AI
Applications
Points de terminaison
Environnements
Licences
Pages de connexion
Pages
Dossiers publiés
Limites de débit
Rôles
Planifications
Scripts
Paramètres
Étiquettes
Déclencheurs
Coffres
Ce qui n'est pas stocké dans le référentiel
Ces entités sont stockées dans la base de données de PowerShell Universal.
Jetons d'application
Identités
Historique des tâches
Modification du référentiel
Vous pouvez modifier les fichiers du référentiel directement dans la console d'administration en accédant à Paramètres \ Fichiers. L'éditeur vous permet de créer des fichiers et des dossiers, et de modifier tout fichier dans le répertoire du référentiel.
Vous pouvez également modifier le référentiel directement sur le disque à l'aide d'éditeurs tels que Visual Studio Code. Par défaut, les fichiers sont stockés dans %ProgramData%\UniversalAutomation\Repository. Vous devrez soit activer le rechargement automatique, soit résoudre les modifications manuellement. Vous pouvez afficher les fichiers modifiés en accédant à Paramètres \ Fichiers \ Suivi de configuration.
Scripts de configuration
Authentication.ps1
Stocké dans .universal\authentication.ps1
Ce script est responsable de la configuration de l'authentification par formulaire. Si l'authentification par formulaire n'est pas utilisée, ce fichier est ignoré.
Vous pouvez utiliser l'applet de commande Set-PSUAuthentication dans ce fichier.
AiAgents.ps1
Stocké dans .universal\aiAgents.ps1
Ce script est responsable de la configuration des agents AI. Utilisez l'applet de commande New-PSUAIAgents dans ce fichier.
AiTools.ps1
Stocké dans .universal\aiTools.ps1
Ce script est responsable de la configuration des outils AI. Utilisez l'applet de commande New-PSUAITool dans ce fichier.
Branding.ps1
Stocké dans .universal\branding.ps1
Ce script est responsable de la configuration des paramètres d'image de marque.
Vous pouvez utiliser l'applet de commande New-PSUBranding dans ce fichier.
Dashboards.ps1
Stocké dans .universal\dashboards.ps1
Ce script est responsable de l'enregistrement des fichiers PS1 en tant qu'applications dans le système. Chaque commande contient les métadonnées de l'application, notamment le nom, l'URL de base et l'environnement.
Vous pouvez utiliser l'applet de commande New-PSUApp dans ce fichier.
Endpoints.ps1
Stocké dans .universal\endpoints.ps1
Ce script est responsable de la définition de tous les points de terminaison API dans l'instance PowerShell Universal.
Vous pouvez utiliser l'applet de commande New-PSUEndpoint dans ce fichier.
Environments.ps1
Stocké dans .universal\environments.ps1
Ce script est responsable de la définition de tous les environnements dans PowerShell Universal.
Vous pouvez utiliser l'applet de commande New-PSUEnvironment dans ce fichier.
healthChecks.ps1
Stocké dans .universal\healthChecks.ps1
Ce script est responsable de la définition des vérifications d'intégrité dans PowerShell Universal.
Vous pouvez utiliser l'applet de commande New-PSUHealthCheck dans ce fichier.
Licenses.ps1
Stocké dans .universal\licenses.ps1
Ce script est responsable de la définition de la licence utilisée dans PowerShell Universal.
Vous pouvez utiliser l'applet de commande Set-PSULicense dans ce fichier.
Initialize.ps1
Stocké dans .universal\initialize.ps1
Ce script s'exécute avant toute configuration dans PowerShell Universal. Le serveur est en cours d'exécution, mais aucun des services n'a démarré. Cela est utile pour installer des modules ou configurer des coffres de secrets avant que la découverte de ces ressources ne soit démarrée.
Middleware.ps1
Stocké dans .universal\middleware.ps1
Permet la personnalisation des requêtes HTTP dans PowerShell Universal.
PublishedFolders.ps1
Stocké dans .universal\publishedFolders.ps1
Ce script est responsable de la configuration des dossiers publiés.
Vous pouvez utiliser l'applet de commande New-PSUPublishedFolder dans ce fichier.
RateLimits.ps1
Stocké dans .universal\rateLimits.ps1
Ce script est responsable de la configuration des limites de débit.
Vous pouvez utiliser l'applet de commande New-PSURateLimit dans ce fichier.
Roles.ps1
Stocké dans .universal\roles.ps1
Ce script est responsable de la configuration des rôles.
Vous pouvez utiliser l'applet de commande New-PSURole dans ce fichier.
Schedules.ps1
Stocké dans .universal\schedules.ps1
Ce script est responsable de la configuration des planifications.
Vous pouvez utiliser l'applet de commande New-PSUSchedule dans ce fichier.
Scripts.ps1
Stocké dans .universal\scripts.ps1
Ce script contient les métadonnées des scripts. Les scripts réels peuvent être stockés n'importe où. Le chemin inclus est relatif au référentiel. Les chemins complets sont également autorisés.
Vous pouvez utiliser l'applet de commande New-PSUScript dans ce fichier.
Settings.ps1
Stocké dans .universal\settings.ps1
Ce script est responsable de la configuration des paramètres système.
Vous pouvez utiliser l'applet de commande Set-PSUSetting dans ce fichier.
Tags.ps1
Stocké dans .universal\tags.ps1
Ce script est responsable de la configuration des étiquettes.
Vous pouvez utiliser l'applet de commande New-PSUTag dans ce fichier.
Triggers.ps1
Stocké dans .universal\triggers.ps1
Ce script est responsable de la configuration des déclencheurs.
Vous pouvez utiliser l'applet de commande New-PSUTrigger dans ce fichier.
Variables.ps1
Stocké dans .universal\variables.ps1
Ce script est responsable de la configuration des variables.
Vous pouvez utiliser l'applet de commande New-PSUVariable dans ce fichier.
Vaults.ps1
Stocké dans .universal\vaults.ps1
Ce script est responsable de la configuration des coffres.
Modèles
En utilisant le dossier Templates dans le référentiel, vous pouvez créer une sélection de modèles d'éléments pour les fonctionnalités couramment utilisées dans PowerShell Universal. Cela inclut les applications, les pages d'application, les scripts et les points de terminaison.
Les fichiers PS1 dans les dossiers suivants seront fournis comme modèles dans la console d'administration.
Templates \ App
Templates \ AppPage
Templates \ Endpoint
Templates \ Script
.psuignore
Le fichier .psuignore peut être utilisé pour exclure certains fichiers ou motifs du surveillant de système de fichiers dans PowerShell Universal. Cela est utile lors de l'enregistrement de fichiers tels que des journaux dans le répertoire du référentiel. Le format du fichier doit être une seule expression régulière par ligne. Si l'expression régulière correspond à un chemin, le système de configuration l'ignorera.
Encodage des fichiers
Vous pouvez configurer l'encodage des fichiers dans la page Paramètres \ Général. Par défaut, PowerShell Universal utilise UTF-8 avec une marque d'ordre d'octet (utf-8-bom) au début du fichier. Si vous souhaitez désactiver la marque d'ordre d'octet, vous pouvez changer l'encodage en utf-8.
Les encodages pris en charge sont ceux retournés par Encoding.GetEncodings. Par exemple :
utf-32utf-32-bomutf-8utf-8-bomwindows-1250
Vous pouvez ajouter -bom à la fin de l'encodage pour ajouter la marque d'ordre d'octet.
Sections de configuration en lecture seule
Les sections en lecture seule vous permettent d'inclure des scripts dans vos fichiers de configuration qui ne seront pas modifiés par les changements effectués dans la console d'administration. Cela vous permet d'exécuter une logique supplémentaire, de générer des ressources dynamiquement et de créer des classes à utiliser dans les schémas OpenAPI.
La région PSUHeader est placée en haut de votre script. PSUFooter est placé en bas.
Ressources de base de données
Vous pouvez éventuellement configurer des ressources pour qu'elles soient stockées dans la base de données plutôt que dans le référentiel de configuration. Ces ressources ne seront plus stockées sur le disque et seront stockées directement dans la base de données. Cela les rend immédiatement disponibles pour tous les ordinateurs connectés dans le cluster PSU.
Lorsque cette option est configurée, les fichiers de configuration des ressources sont ignorés.
Certaines ressources ne sont pas prises en charge. Il s'agit notamment de :
Applications
Points de terminaison avec des chemins
Scripts
Modules
Pour configurer une ressource pour la persistance en base de données, vous devez configurer les paramètres de l'application pour chaque type de classe. Voici un exemple de stockage des planifications dans la base de données.
Mis à jour
Ce contenu vous a-t-il été utile ?