Ctrlk
Demo buchenOn-Demand-LabAcademyDownload-Center
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Repository

Die Konfigurationsdaten für PowerShell Universal werden primär innerhalb des Repositorys gespeichert. Standardmäßig befindet sich der Repository-Ordner unter %ProgramData%\UniversalAutomation\Repository. Sie können den Speicherort des Repositorys anpassen, indem Sie die Datei appsettings.json bearbeiten.

Das Repository enthält PowerShell-Skripte und XML-Dateien, die bei der Verwendung der PowerShell Universal-Verwaltungskonsole erzeugt werden. Der Repository-Ordner wird außerdem auf Änderungen überwacht, sodass jede auf der Festplatte vorgenommene Änderung dazu führt, dass das System die Datei neu lädt und die Plattform neu konfiguriert. Bei Verwendung der Git-Integration ist der Repository-Ordner derjenige, der mit dem Git-Remote synchronisiert wird.

Alle Konfigurations-Cmdlets sind Teil des Moduls Universal .

Was im Repository gespeichert wird

Dateien im Repository werden als Klartext gespeichert, um einen einfachen Vergleich mit Quellcodeverwaltungstools zu ermöglichen.

  • Authentifizierung

  • KI-Agenten und Tools

  • Apps

  • Endpunkte

  • Umgebungen

  • Lizenzen

  • Anmeldeseiten

  • Seiten

  • Veröffentlichte Ordner

  • Ratenbegrenzungen

  • Rollen

  • Zeitpläne

  • Skripte

  • Einstellungen

  • Tags

  • Trigger

  • Tresore

Was nicht im Repository gespeichert wird

Diese Entitäten werden in der PowerShell Universal-Datenbank gespeichert.

  • App-Tokens

  • Identitäten

  • Auftragsverlauf

Bearbeiten des Repositorys

Sie können die Repository-Dateien direkt in der Verwaltungskonsole bearbeiten, indem Sie zu Einstellungen \ Dateien navigieren. Der Editor ermöglicht es Ihnen, Dateien und Ordner zu erstellen und jede Datei innerhalb des Repository-Verzeichnisses zu bearbeiten.

Sie können das Repository auch direkt auf der Festplatte mit Editoren wie Visual Studio Code bearbeiten. Standardmäßig werden Dateien in %ProgramData%\UniversalAutomation\Repository gespeichert. Sie müssen entweder das automatische Neuladen aktivieren oder Änderungen manuell auflösen. Sie können geänderte Dateien anzeigen, indem Sie zu Einstellungen \ Dateien \ Konfigurations-Tracker navigieren.

Konfigurationsskripte

Authentication.ps1

Gespeichert in .universal\authentication.ps1

Dieses Skript ist für die Konfiguration der Formularauthentifizierung verantwortlich. Wenn die Formularauthentifizierung nicht verwendet wird, wird diese Datei ignoriert.

Sie können das Cmdlet Set-PSUAuthentication in dieser Datei verwenden.

AiAgents.ps1

Gespeichert in .universal\aiAgents.ps1

Dieses Skript ist für die Konfiguration von KI-Agenten verantwortlich. Verwenden Sie das Cmdlet New-PSUAIAgents in dieser Datei.

AiTools.ps1

Gespeichert in .universal\aiTools.ps1

Dieses Skript ist für die Konfiguration von KI-Tools verantwortlich. Verwenden Sie das Cmdlet New-PSUAITool in dieser Datei.

Branding.ps1

Gespeichert in .universal\branding.ps1

Dieses Skript ist für die Konfiguration der Branding-Einstellungen verantwortlich.

Sie können das Cmdlet New-PSUBranding in dieser Datei verwenden.

Dashboards.ps1

Gespeichert in .universal\dashboards.ps1

Dieses Skript ist für die Registrierung von PS1-Dateien als Apps innerhalb des Systems verantwortlich. Jeder Befehl enthält die Metadaten für die App, einschließlich Name, Basis-URL und Umgebung.

Sie können das Cmdlet New-PSUApp in dieser Datei verwenden.

Endpoints.ps1

Gespeichert in .universal\endpoints.ps1

Dieses Skript ist für die Definition aller API-Endpunkte innerhalb der PowerShell Universal-Instanz verantwortlich.

Sie können das Cmdlet New-PSUEndpoint in dieser Datei verwenden.

Environments.ps1

Gespeichert in .universal\environments.ps1

Dieses Skript ist für die Definition aller Umgebungen innerhalb von PowerShell Universal verantwortlich.

Sie können das Cmdlet New-PSUEnvironment in dieser Datei verwenden.

healthChecks.ps1

Gespeichert in .universal\healthChecks.ps1

Dieses Skript ist für die Definition von Health Checks innerhalb von PowerShell Universal verantwortlich.

Sie können das Cmdlet New-PSUHealthCheck in dieser Datei verwenden.

Licenses.ps1

Gespeichert in .universal\licenses.ps1

Dieses Skript ist für die Definition der in PowerShell Universal verwendeten Lizenz verantwortlich.

Sie können das Cmdlet Set-PSULicense in dieser Datei verwenden.

Initialize.ps1

Gespeichert in .universal\initialize.ps1

Dieses Skript wird ausgeführt, bevor innerhalb von PowerShell Universal eine Konfiguration erfolgt. Der Server läuft, aber keiner der Dienste wurde gestartet. Dies ist nützlich, um Module zu installieren oder Geheimnis-Tresore zu konfigurieren, bevor die Erkennung dieser Ressourcen gestartet wird.

Middleware.ps1

Gespeichert in .universal\middleware.ps1

Ermöglicht die Anpassung der HTTP-Anfragen in PowerShell Universal.

PublishedFolders.ps1

Gespeichert in .universal\publishedFolders.ps1

Dieses Skript ist für die Konfiguration von veröffentlichten Ordnern verantwortlich.

Sie können das Cmdlet New-PSUPublishedFolder in dieser Datei verwenden.

RateLimits.ps1

Gespeichert in .universal\rateLimits.ps1

Dieses Skript ist für die Konfiguration von Ratenbegrenzungen verantwortlich.

Sie können das Cmdlet New-PSURateLimit in dieser Datei verwenden.

Roles.ps1

Gespeichert in .universal\roles.ps1

Dieses Skript ist für die Konfiguration von Rollen verantwortlich.

Sie können das Cmdlet New-PSURole in dieser Datei verwenden.

Schedules.ps1

Gespeichert in .universal\schedules.ps1

Dieses Skript ist für die Konfiguration von Zeitplänen verantwortlich.

Sie können das Cmdlet New-PSUSchedule in dieser Datei verwenden.

Scripts.ps1

Gespeichert in .universal\scripts.ps1

Dieses Skript enthält die Metadaten für Skripte. Die eigentlichen Skripte können an beliebiger Stelle gespeichert werden. Der angegebene Pfad ist relativ zum Repository. Vollständige Pfadnamen sind ebenfalls zulässig.

Sie können das Cmdlet New-PSUScript in dieser Datei verwenden.

Settings.ps1

Gespeichert in .universal\settings.ps1

Dieses Skript ist für die Konfiguration der System-Einstellungen verantwortlich.

Sie können das Cmdlet Set-PSUSetting in dieser Datei verwenden.

Tags.ps1

Gespeichert in .universal\tags.ps1

Dieses Skript ist für die Konfiguration von Tags verantwortlich.

Sie können das Cmdlet New-PSUTag in dieser Datei verwenden.

Triggers.ps1

Gespeichert in .universal\triggers.ps1

Dieses Skript ist für die Konfiguration von Triggern verantwortlich.

Sie können das Cmdlet New-PSUTrigger in dieser Datei verwenden.

Variables.ps1

Gespeichert in .universal\variables.ps1

Dieses Skript ist für die Konfiguration von Variablen verantwortlich.

Sie können das Cmdlet New-PSUVariable in dieser Datei verwenden.

Vaults.ps1

Gespeichert in .universal\vaults.ps1

Dieses Skript ist für die Konfiguration von Tresoren verantwortlich.

Vorlagen

Über den Ordner Templates innerhalb des Repositorys können Sie eine Auswahl von Elementvorlagen für häufig verwendete Funktionen in PowerShell Universal erstellen. Dazu gehören Apps, App-Seiten, Skripte und Endpunkte.

Skriptvorlage

PS1-Dateien in den folgenden Ordnern werden in der Verwaltungskonsole als Vorlagen bereitgestellt.

  • Templates \ App

  • Templates \ AppPage

  • Templates \ Endpoint

  • Templates \ Script

.psuignore

Die Datei .psuignore kann verwendet werden, um bestimmte Dateien oder Muster aus dem Dateisystem-Watcher in PowerShell Universal auszuschließen. Dies ist nützlich, wenn Dateien wie Protokolle im Repository-Verzeichnis gespeichert werden. Das Format der Datei sollte ein einzelner regulärer Ausdruck pro Zeile sein. Wenn der reguläre Ausdruck auf einen Pfad passt, ignoriert das Konfigurationssystem diesen.

Dateikodierung

Sie können die Dateikodierung auf der Seite Einstellungen \ Allgemein konfigurieren. Standardmäßig verwendet PowerShell Universal UTF-8 mit einer Bytereihenfolge-Markierung (utf-8-bom) am Anfang der Datei. Wenn Sie die Bytereihenfolge-Markierung deaktivieren möchten, können Sie die Kodierung auf utf-8 ändern.

Unterstützte Kodierungen sind alle, die von Encoding.GetEncodings zurückgegeben werden. Zum Beispiel:

  • utf-32

  • utf-32-bom

  • utf-8

  • utf-8-bom

  • windows-1250

Sie können -bom an das Ende der Kodierung anfügen, um die Bytereihenfolge-Markierung hinzuzufügen.

Schreibgeschützte Konfigurationsabschnitte

Schreibgeschützte Abschnitte ermöglichen es Ihnen, Skripte in Ihre Konfigurationsdateien einzubinden, die von Änderungen in der Admin-Konsole nicht berührt werden. Dadurch können Sie zusätzliche Logik ausführen, Ressourcen dynamisch generieren und Klassen zur Verwendung in OpenAPI-Schemas erstellen.

Die Region PSUHeader wird am Anfang Ihres Skripts platziert. PSUFooter wird am Ende platziert.

Datenbankressourcen

Sie können optional konfigurieren, dass Ressourcen in der Datenbank anstatt im Konfigurations-Repository gespeichert werden. Diese Ressourcen werden nicht mehr auf der Festplatte, sondern direkt in der Datenbank gespeichert. Dadurch stehen sie sofort für alle verbundenen Computer im PSU-Cluster zur Verfügung.

Wenn dies konfiguriert ist, werden Konfigurationsdateien für Ressourcen ignoriert.

Einige Ressourcen werden nicht unterstützt. Dazu gehören:

  • Apps

  • Endpunkte mit Pfaden

  • Skripte

  • Module

Um eine Ressource für die Datenbankpersistenz zu konfigurieren, müssen Sie die App-Einstellungen für jeden Klassentyp einrichten. Unten finden Sie ein Beispiel für das Speichern von Zeitplänen in der Datenbank.

Vorherigepsu-Befehlszeilenwerkzeug
NächsteAusführung als Dienstkonto

Zuletzt aktualisiert

War das hilfreich?