Cmdlet Start UntisBackup

Start-UntisBackup

Erstellt eine gpn-Backupdatei für eine Untis-Datenbank (nur Untis MultiUser)

Start-UntisBackup 
    -SchoolNo <String>
    -SchoolYear <String>
    [-Version <Int>]
    -User <String>
    -Password <SecureString>
    -BackupFile <String>

Beschreibung

Das Cmdlet Start-UntisBackup kapselt den Untis-Komandozeilenbefehl zum Erstellen einer Backupdatei beim Einsatz von Untis MultiUser. Start-UntisBackup unterstützt Untis MultiUser in den Versionen 2017 bis 2024.

Konnte keine Backupdatei erstellt werden, gibt Start-UntisBackup eine Fehlermeldung aus.

Bitte beachte, dass die Eingabe des Kennworts beim Parameter -Password einen SecureString erfordert. In der Regel nutzt man dafür das Cmdlet ConvertTo-SecureString (siehe Beispiele weiter unten).

Beispiele

Beispiel

Erstellen einer Backup-Datei aus einer Untis-Datenbank.

Start-UntisBackup -SchoolNo 12345 -SchoolYear 2020-2021 -User Administrator -Password (ConvertTo-SecureString 'qwertz' -AsPlainText -Force) -BackupFile c:\output\backup.gpn

Parameter

• -SchoolNo

  Schulnummer bei Zugriff auf Untis-Datenbank

• -SchoolYear

  Schuljahr bei Zugriff auf Untis-Datenbank

• -Version

  Planversion bei Zugriff auf Untis-Datenbank. Diese Angabe ist optional. Der Standardwert ist 1.

• -User

  Benutzer bei Zugriff auf Untis-Datenbank

• -Password

  Kennwort bei Zugriff auf Untis-Datenbank. Erfordert einen SecureString.

• -BackupFile

  Dateipfad für die Backup-Datei.