Logoff

1.8.2.4. Vierter Schritt – Logoff

Der Abschnitt Logoff ist dem Abschnitt Logon sehr ähnlich, mit dem Unterschied, dass alle hier definierten Funktionen nicht beim Logon des Benutzers ausgeführt werden, sondern beim Logoff.

Abbildung: Logoff

Abbildung: Logoff

1.8.2.5. Fünfter Schritt – Zusammenfassung

Der Abschnitt Zusammenfassung listet noch einmal alle Details zu dem Profile Package auf, bevor dieses erstellt wird. Abgeschlossen wird das Profile Package über „Speichern“ oder F5.

Abbildung: Zusammenfassung

Abbildung: Zusammenfassung

1.11. PSPM – Funktionsumfang – Logoff

Das Hauptanwendungsgebiet des PowerShell Profile Managers ist die Erstellung von Benutzerprofil Konfigurationen. Diese Konfigurationen können eingesetzt werden, Windows Benutzerprofile zu konfigurieren und zu konfigurieren. Um solche Konfigurationen zu erstellen bietet das PSPM sogenannte „Funktionen“. Diese können miteinander kombiniert werden um eine Konfiguration zu erstellen. Die möglichen „Funktionssets“ lauten wie folgt:

  • AppLocker
  • Compression
  • Dialog
  • Directory
  • Drive
  • Environment
  • Files
  • Printer
  • Process
  • Registry
  • Script

Jedes Funktionsset beinhaltet vordefinierte Funktionen. Sie können diesen Funktionen zusätzliche Parameter und Werte zuweisen.

Abbildung: Übersicht Funktionen beim User Logoff

Abbildung: Übersicht Funktionen beim User Logoff

Der Prozess sieht immer gleich aus: Zuerst wird eine Funktion aus einem Funktionsset ausgewählt, dann werden die gewünschten Parameter bestimmt. Anschließend werden für diese Parameter Werte spezifiziert und schließlich mittels „Action Hinzufügen" der Profilkonfiguration hinzugefügt. Bei den Parametern wird zwischen Pflichtparametern (sind immer als „ausgewählt“ markiert) und optionalen Parametern unterschieden.

1.11.1. Logoff: AppLocker

Im Funktionsset AppLocker können folgende Funktionen genutzt werden:

  • Add AppRule
  • Add DirectoryRule
  • Add PublisherRule
  • Clear AppLockerRules
  • Set AppLockerDefaultRules

Abbildung: AppLocker

Abbildung: Add AppRule

1.11.1.1. Logoff: Add AppRule

Mittels der Funktion „Add AppRule“ wird eine neue AppLocker Regel erstellt, welche es einer bestimmten Applikation erlaubt oder verbietet ausgeführt zu werden.

Tabelle: Add AppRule

Parameter Beschreibung Datentyp Pflichtparameter
Action Bestimmt ob die Regel eine Ausführung erlaubt (Allow) oder verbietet (Deny). Textfeld Ja
Account Bestimmt das Benutzerkonto, welchem diese Regel zugeordnet wird. Standardwert: Aktueller Profilbenutzer Textfeld Nein
FromName Bestimmt die Applikation anhand des vollen Produktnamens, wie er in dem signierten Applikationszertifikat beschrieben ist. Textfeld Nein
FromFilePath Bestimmt die Applikation anhand des Pfades der auszuführenden Datei. Für signierte Applikationen wird eine Herstellerregel erstellt und für nicht signierte Applikationen eine Pfadregel. Textfeld Nein
ContinueOnError Wenn ein Fehler auftritt, mit der nächsten Funktion fortfahren. Wahrheitswert Nein

Abbildung: Add AppRule

Abbildung: Add AppRule

1.11.1.2. Logoff: Add DirectoryRule

Mittels der Funktion „Add DirectoryRule“ wird eine neue AppLocker Regel erstellt, welche es allen Applikationen in diesem Ordner erlaubt oder verbietet ausgeführt zu werden.

Tabelle: Add DirectoryRule

Parameter Beschreibung Datentyp Pflichtparameter
Action Bestimmt ob die Regel eine Ausführung erlaubt (Allow) oder verbietet (Deny). Textfeld Ja
Account Bestimmt das Benutzerkonto, welchem diese Regel zugeordnet wird. Standardwert: Aktueller Profilbenutzer Textfeld Nein
DirectoryPath Der Pfad zu dem jeweiligen Ordner, indem sich die Applikationen befinden. Textfeld Nein
ContinueOnError Wenn ein Fehler auftritt, mit der nächsten Funktion fortfahren. Wahrheitswert Nein

Abbildung: Add DirectoryRule

Abbildung: Add DirectoryRule

1.11.1.3. Logoff: Add PublisherRule

Mittels der Funktion „Add PublisherRule“ wird eine neue AppLocker Regel erstellt, welche es allen Applikationen von einem bestimmten Hersteller erlaubt oder verbietet ausgeführt zu werden.

Tabelle: Add PublisherRule

Parameter Beschreibung Datentyp Pflichtparameter
Action Bestimmt ob die Regel eine Ausführung erlaubt (Allow) oder verbietet (Deny). Textfeld Ja
Account Bestimmt das Benutzerkonto, welchem diese Regel zugeordnet wird. Standardwert: Aktueller Profilbenutzer Textfeld Nein
FromName Bestimmt die Applikation anhand des vollen Produktnamens, wie er in dem signierten Applikationszertifikat beschrieben ist. Textfeld Nein
FromFilePath Bestimmt die Applikation anhand des Pfades der auszuführenden Datei. Für signierte Applikationen wird eine Herstellerregel erstellt und für nicht signierte Applikationen eine Pfadregel. Textfeld Nein
ContinueOnError Wenn ein Fehler auftritt, mit der nächsten Funktion fortfahren. Wahrheitswert Nein

Abbildung: Add PublisherRule

Abbildung: Add PublisherRule

1.11.1.4. Logoff: Clear AppLockerRules

Mittels der Funktion „Clear AppLockerRules“ können existierende AppLocker Regeln entfernt werden und AppLocker deaktiviert werden. Standardmäßig werden nur die PSPM AppLocker Regeln entfernt. Optional können auch alle anderen Regeln entfernt werden.

Tabelle: Clear AppLockerRules

Parameter Beschreibung Datentyp Pflichtparameter
Action Bestimmt ob die Regel eine Ausführung erlaubt (Allow) oder verbietet (Deny). Textfeld Nein
Account Bestimmt das Benutzerkonto, welchem diese Regel zugeordnet wird. Standardwert: Aktueller Profilbenutzer Textfeld Nein
AllAccount Bewirkt das Löschenvon PSPM AppLocker Regeln für alle Benutzerkonten. Wahrheitswert Nein
AllRules Bewirkt das Löschen von AppLocker Regeln, welche nicht von PSPM konfiguriert worden sind. Wahrheitswert Nein
Disable Bewirkt die Deaktivierung aller AppLocker Regeln, indem der Auditing Modus aktiviert wird. Wahrheitswert Nein
ContinueOnError Wenn ein Fehler auftritt, mit der nächsten Funktion fortfahren. Wahrheitswert Nein

Abbildung: Clear AppLockerRules

Abbildung: Clear AppLockerRules

1.11.1.5. Logoff: Set AppLockerDefaultRules

Mittels der Funktion „Set AppLockerDefaultRules“ werden minimale AppLocker Regeln erstellt, welche nötig sind damit sowohl einerseits Windows sowie dessen Applikationen korrekt ausgeführt als auch die PSPM Komponenten freigeschaltet werden. Zusätzlich können grundsätzliche nützliche Regeln erstellt werden, wie zum Beispiel, dass alle Microsoft eigene Produkte erlaubt werden.

Tabelle: Set AppLockerDefaultRules

Parameter Beschreibung Datentyp Pflichtparameter
Action Bestimmt ob die Regel eine Ausführung erlaubt (Allow) oder verbietet (Deny). Textfeld Nein
MicrosoftApps Erlaubt die Ausführung aller Microsoft-Applikationen Wahrheitswert Nein
InstalledApps Erlaubt die Ausführung aller Applikationen im Verzeichnis “Programme” Wahrheitswert Nein
OnlySignedApps Erlaubt die Ausführung aller signierten Programme Wahrheitswert Nein
FullPowerShell Erlaubt die Bereitstellung der vollen PowerShell-Funktionalität Wahrheitswert Nein
ContinueOnError Wenn ein Fehler auftritt, mit der nächsten Funktion fortfahren. Wahrheitswert Nein

Abbildung: Set AppLockerDefaultRules

Abbildung: Set AppLockerDefaultRules

1.11.1.6. Logoff: Beispiel - AppLocker

Als Beispiel wird die Funktion „Clear AppLockerRules“ verwendet.

Tabelle: AppLocker Beispielparameter

Parameter Wert des Parameters
Disable Wahr
ContinueOnError Wahr

Abbildung: Beispiel –  AppLocker Abbildung: Beispiel –  AppLocker

Abbildung: Beispiel – AppLocker

1.11.2. Logoff: Compression

Das Funktionsset “Compression” behandelt das Erstellen und Extrahieren von Dateiarchiven (.zip). Die Optionen hier sind:

  • Create ZipArchive
  • Extract ZipArchive

Abbildung: Compression

Abbildung: Compression

1.11.2.1. Logoff: Create ZipArchive

Die Funktion “Create ZipArchive” erstellt aus einem angegeben Verzeichnispfad ein komprimiertes Dateiarchiv (.zip).

Tabelle: Create ZipArchive

Parameter Beschreibung Datentyp Pflichtparameter
SourcePath Verzeichnis, das komprimiert werden soll Textfeld Ja
ArchiveName Name des generierten ZIP-Archivs Textfeld Nein
Compression Angabe des Kompressionsverfahrens(Standard: Schnell): Schnell (Fast), Effektiv (Effective), Keine (None) Listenfeld Nein
Continue on Error Wenn ein Fehler auftritt, mit der nächsten Funktion fortfahren Wahrheitswert Nein

Abbildung: Create ZipArchive

Abbildung: Create ZipArchive

1.11.2.2. Logoff: Extract ZipArchive

Die Funktion “Extract ZipArchive” extrahiert ein Dateiarchiv (.zip).

Tabelle: Extract ZipArchive

Parameter Beschreibung Datentyp Pflichtparameter
ArchiveFilePath Pfad zum Dateiarchiv (.zip) , welches extrahiert werden soll Textfeld Ja
Continue on Error Wenn ein Fehler auftritt, mit der nächsten Funktion fortfahren Wahrheitswert Nein

Abbildung: Extract ZipArchive

Abbildung: Extract ZipArchive

1.11.2.3. Logoff: Beispiel Compression

Als Beispiel wird die Funktion „Create ZipArchive“ verwendet.

Tabelle: Compression Beispielparameter

Parameter Wert des Parameters
Source Path $dirFiles\Benutzerdefinierte Office-Vorlagen
Compression Fast

Abbildung: Beispiel – Compression Abbildung: Beispiel – Compression

Abbildung: Beispiel – Compression

1.11.3. Logoff: Dialog

Dieses Funktionsset behandelt Meldungen. Die Optionen hier sind folgende:

  • Close Notification
  • Show Notification

Abbildung: Dialog

Abbildung: Dialog

1.11.3.1. Logoff: Close Notification

Die Funktion „Close Notification“ schließt die derzeit für den Benutzer angezeigt Meldung. Für diese Funktion werden keine gesonderten Parameter benötigt.

1.11.3.2. Logoff: Show Notification

Sollen nach dem Logoff Meldungen zu durchgeführten Operationen angezeigt werden, wird die Funktion „Show Notification“ genutzt.

Tabelle: Show Notification

Parameter Beschreibung Datentyp Pflichtparameter
Title Titel, welcher dem Benutzer angezeigt wird Textfeld Ja
Message Inhalt der Meldung für den Benutzer Textfeld Ja
ImagePath Der Pfad zur Bilddatei, welche in die Meldung eingebunden werden soll Textfeld Nein
Duration Die Anzeigedauer der Meldung in Millisekunden Textfeld Nein
TitleColor Farbe für Titel, Standard: Windows-Designfarbe Textfeld Nein
BackgroundColor Farbe für den Hintergrund der Benachrichtigungsansicht, Standard: Windows-Designfarbe Textfeld Nein
Message Color Die Farbe für die Nachricht. Standard: Windows-Designfarbe Textfeld Nein
Opacity Transparenz der Benachrichtigung, Standard: 0,8 keine Transparenz Textfeld Nein

Abbildung: Show Notification

Abbildung: Show Notification

1.11.3.3. Logoff: Beispiel - Dialog

Als Beispiel für das Funktionsset Dialog ist für den Logoff Prozess die Funktion Show Notification gewählt worden.

Tabelle: Dialog Beispielparameter

Parameter Wert des Parameters
Title Test notification
Message This is a test.
ImagePath $dirFiles\test.jpg
Duration 0

Abbildung: Beispiel – Dialog Abbildung: Beispiel – Dialog

Abbildung: Beispiel – Dialog

1.11.4. Logoff: Directory

Im Funktionsset Directory können folgenden Funktionen genutzt werden:

  • Copy Directory
  • Delete Directory
  • Sync Directory

Abbildung: Directory

Abbildung: Directory

1.11.4.1. Logoff: Copy Directory

Mittels der Funktion „Copy Directory“ wird ein Verzeichnis (bei Bedarf inklusive aller Unterverzeichnisse) an ein definiertes Ziel kopiert.

Tabelle: Copy Directory

Parameter Beschreibung Datentyp Pflichtparameter
SourcePath Pfad des Quellverzeichnisses Textfeld Ja
DestinationPath Pfad des Zielverzeichnisses Textfeld Ja
Include Filter, um Dateien zu bestimmen, welche vom Quellverzeichnis ins Zielverzeichnis übernommen werden sollen. Mit dem Wildcard Zeichen „*“ und dem Platzhalterzeichen „?“ kann der Filter variabel gestaltet werden. Es können mehrere Filterausdrücke spezifiziert werden. Textfeld Nein
Exclude Ein Filter, um Dateien zu bestimmen, welche vom Quellverzeichnis ins Zielverzeichnis nicht übernommen werden sollen. Mit dem Wildcard Zeichen „*“ und dem Platzhalterzeichen „?“ kann der Filter variabel gestaltet werden. Es können mehrere Filterausdrücke spezifiziert werden. Textfeld Nein
Recurse Alle Unterordner und Dateien übernehmen Wahrheitswert Nein
Overwrite Angabe, ob vorhandene Dateien überschrieben werden sollen Wahrheitswert Nein
Continue on Error Wenn ein Fehler auftritt, mit der nächsten Funktion fortfahren Wahrheitswert Nein

Abbildung: Copy Directory

Abbildung: Copy Directory

1.11.4.2. Logoff: Delete Directory

Die Funktion „Delete Directory“ löscht ein gesamtes Verzeichnis.

Tabelle: Delete Directory

Parameter Beschreibung Datentyp Pflichtparameter
Path Pfad des Quellverzeichnisses Textfeld Ja
Continue on Error Wenn ein Fehler auftritt, mit der nächsten Funktion fortfahren Wahrheitswert Nein

Abbildung: Delete Directory

Abbildung: Delete Directory

1.11.4.3. Logoff: Sync Directory

Sollen zwei Verzeichnisse miteinander synchronisiert werden, kommt die Funktion „Sync Directory“ zum Einsatz.

Tabelle: Sync Directory

Parameter Beschreibung Datentyp Pflichtparameter
SourcePath Pfad des Quellverzeichnisses Textfeld Ja
DestinationPath Pfad des Zielverzeichnisses Textfeld Ja
Include Filter, um Dateien zu bestimmen, welche vom Quellverzeichnis ins Zielverzeichnis synchronisiert werden sollen. Mit dem Wildcard Zeichen „*“ und dem Platzhalterzeichen „?“ kann der Filter variabel gestaltet werden. Es können mehrere Filterausdrücke spezifiziert werden. Textfeld Nein
Exclude Ein Filter, um Dateien zu bestimmen, welche vom Quellverzeichnis ins Zielverzeichnis nicht synchronisiert werden sollen. Mit dem Wildcard Zeichen „*“ und dem Platzhalterzeichen „?“ kann der Filter variabel gestaltet werden. Es können mehrere Filterausdrücke spezifiziert werden. Textfeld Nein
Strict Löscht Verzeichnisse und Ordner im Zielverzeichnis, die nicht im Quellverzeichnis existieren Wahrheitswert Nein
SyncEmptyDirectories Angabe, ob Verzeichnisse ohne Dateien erstellt werden sollen Wahrheitswert Nein
SyncPermission Die NTFS-Berechtigungen des Verzeichnisses werden kopiert Wahrheitswert Nein
Continue on Error Wenn ein Fehler auftritt, mit der nächsten Funktion fortfahren Wahrheitswert Nein

Abbildung: Sync Directory

Abbildung: Sync Directory

1.11.4.4. Logoff: Beispiel - Directory

Beispielhaft wird die Funktion „Copy Directory” mit folgenden Parametern konfiguriert.

Tabelle: Directory Beispielparameter

Parameter Wert des Parameters
SourcePath %HOMEPATH%\Config\FileZilla
DestinationPath %AppData%\FileZilla
Include config*.xml
Recurse Wahr
ContinueOnError Wahr

Abbildung: Beispiel - Directory Abbildung: Beispiel - Directory

Abbildung: Beispiel - Directory

1.11.5. Logoff: Drive

Das Funktionsset „Drive“ ermöglicht das Verbinden oder Trennen von Laufwerken. Die beiden möglichen Funktionen lauten:

  • Map Drive
  • Unmap Drive

Abbildung: Drive

Abbildung: Drive

1.11.5.1. Logoff: Map Drive

Zur Verbindung eines Laufwerks ist die Funktion „Map Drive“ erforderlich.

Tabelle: Map Drive

Parameter Beschreibung Datentyp Pflichtparameter
DriveLetter Angabe des Laufwerksbuchstabens Textfeld Ja
UncPath Spezifiziert den Netzwerkpfad zum Laufwerk (hierbei kann es sich um ein lokales Laufwerk handeln) Textfeld Ja
DriveLabel Angabe der Bezeichnung der Beschriftung des zugeordneten Laufwerks an (wird für intern zugeordnete Laufwerke ignoriert) Textfeld Nein
Internal Angabe, ob das zugeordnete Laufwerk nur von der aktuellen aktiven PowerShell-Sitzung und nicht von Windows verwendet werden soll Wahrheitswert Nein
Continue on Error Wenn ein Fehler auftritt, mit der nächsten Funktion fortfahren Wahrheitswert Nein

Abbildung: Map Drive

Abbildung: Map Drive

1.11.5.2. Logoff: Unmap Drive

Mit dieser Funktion werden verbundene Laufwerke getrennt.

Tabelle: Unmap Drive

Parameter Beschreibung Datentyp Pflichtparameter
DriveLetter Angabe des Laufwerksbuchstabens Textfeld Ja
Continue on Error Wenn ein Fehler auftritt, mit der nächsten Funktion fortfahren Wahrheitswert Nein

Abbildung: Unmap Drive

Abbildung: Unmap Drive

1.11.5.3. Logoff: Beispiel - Drive

Beispielhaft wird die Funktion „Map Drive“ konfiguriert.

Tabelle: Drive Beispielparameter

Parameter Wert des Parameters
DriveLetter R
UncPath \ \SERVERNAME\MaxMustermann\Documents\
ContinueOnError Wahr

Abbildung: Beispiel - Drive Abbildung: Beispiel - Drive

Abbildung: Beispiel - Drive

1.11.6. Logoff: Environment

Das Funktionsset „Environment“ umfasst die Funktionen:

  • Remove EnvironmentVariable
  • Set EnvironmentVariable

Abbildung: Environment

Abbildung: Environment

1.11.6.1. Logoff: Remove EnvironmentVariable

Sollte der Bedarf gegeben sein, eine Umgebungsvariable zu löschen, wird die Funktion “Remove Environment Variable“ herangezogen.

Tabelle: Remove EnvironmentVariable

Parameter Beschreibung Datentyp Pflichtparameter
Name Spezifiziert den Name der Umgebungsvariable Textfeld Ja
Scope Spezifiziert den Umfang der Umgebungsvariablen (User, Machine, Process) Textfeld Nein
Continue on Error Wenn ein Fehler auftritt, mit der nächsten Funktion fortfahren Wahrheitswert Nein

Abbildung: Remove EnvironmentVariable

Abbildung: Remove EnvironmentVariable

1.11.6.2. Logoff: Set EnvironmentVariable

Gegenstück zur vorherigen Funktion des Funktionssets “Environment“ bildet die Funktion „Set EnvironmentVariable“.

Tabelle: Set EnvironmentVariable

Parameter Beschreibung Datentyp Pflichtparameter
Name Spezifiziert den Name der Umgebungsvariable Textfeld Ja
Value Spezifiziert den Wert der Umgebungsvariable Textfeld Ja
Scope Spezifiziert den Umfang der Umgebungsvariablen (User, Machine, Process) Textfeld Nein
Continue on Error Wenn ein Fehler auftritt, mit der nächsten Funktion fortfahren Wahrheitswert Nein

Abbildung: Set EnvironmentVariable

Abbildung: Set EnvironmentVariable

1.11.6.3. Logoff: Beispiel - Environment

Beispielhaft wird hier die Funktion „Set EnvironmentVariable“ konfiguriert.

Tabelle: Environment Beispielparameter

Parameter Wert des Parameters
Name Environment
Value UAT
Scope Machine
ContinueOnError Wahr

Abbildung: Beispiel - Environment Abbildung: Beispiel - Environment

Abbildung: Beispiel - Environment

1.11.7. Logoff: File

Mit dem Funktionsset Files bietet sich der gleiche Funktionsumfang wie bei „Directory“, hier jedoch für eine einzelne Datei. Das Funktionsset bietet die folgenden Funktionen:

  • Copy File
  • Delete File
  • Sync File

Abbildung: File

Abbildung: File

1.11.7.1. Logoff: Copy File

Die erste Funktion des Funktionssets lautet “Copy File“.

Tabelle: Copy File

Parameter Beschreibung Datentyp Pflichtparameter
FilePath Pfad der zu kopierenden Datei Textfeld Ja
DestinationPath Zielverzeichnis für die zu kopierende Datei Textfeld Ja
ContinueOnError Wenn ein Fehler auftritt, mit der nächsten Funktion fortfahren Wahrheitswert Nein

Abbildung: Copy File

Abbildung: Copy File

1.11.7.2. Logoff: Delete File

Zum Löschen wird die Funktion „Delete File” genutzt.

Tabelle: Delete File

Parameter Beschreibung Datentyp Pflichtparameter
FilePath Pfad der zu löschenden Datei Textfeld Ja
ContinueOnError Wenn ein Fehler auftritt, mit der nächsten Funktion fortfahren Wahrheitswert Nein

Abbildung: Copy File

Abbildung: Delete File

1.11.7.3. Logoff: Sync File

Dateien werden mittels der Funktion „Sync File“ synchronisiert.

Tabelle: Sync File

Parameter Beschreibung Datentyp Pflichtparameter
SourcePath Pfad der zu kopierenden Datei Textfeld Ja
DestinationPath Zielverzeichnis für die zu synchronisierende Datei Textfeld Ja
FileName Angabe des Dateinamens mit der Dateiendung Textfeld Ja
SyncPermission Die NTFS Berechtigungen des Verzeichnisses werden kopiert Wahrheitswert Nein
ContinueOnError Wenn ein Fehler auftritt, mit der nächsten Funktion fortfahren Wahrheitswert Nein

Abbildung: Sync File

Abbildung: Sync File

1.11.7.4. Logoff: Beispiel - File

Erstellung eines Beispiels anhand der Funktion „Sync File“.

Tabelle: File Beispielparameter

Parameter Wert des Parameters
SourcePath %HOMEPATH%\Config\FileZilla
DestinationPath %AppData%\FileZilla
FileName FileZilla.xml
SyncPermission Wahr
ContinueOnError Wahr

Abbildung: Beispiel - File Abbildung: Beispiel - File

Abbildung: Beispiel - File

1.11.8. Logoff: Printer

In dem Funktionsset Printer können Drucker verbunden oder getrennt werden. Die hier enthaltenen Funktionen lauten:

  • Create NetworkPrinter
  • Create SharedPrinter
  • Delete Printer
  • Set DefaultPrinter

Abbildung: Printer

Abbildung: Printer

1.11.8.1. Logoff: Create NetworkPrinter

Einen Netzwerkdrucker beim Logoff eines Windows Benutzers zu verbinden wird mittels der Funktion „Create Network Printer“ durchgeführt.

Tabelle: Create NetworkPrinter

Parameter Beschreibung Datentyp Pflichtparameter
Name Name des Druckers Textfeld Ja
DriverName Name des Druckertreibers Textfeld Ja
IpOrDnsAddress Die IP oder DNS Adresse des Druckers Ja
PrinterPortName Spezifiziert den Namen des Ports für den Drucker Textfeld Ja
ContinueOnError Wenn ein Fehler auftritt, mit der nächsten Funktion fortfahren Wahrheitswert Nein

Abbildung: Create Network Printer

Abbildung: Create Network Printer

1.11.8.2. Logoff: Create SharedPrinter

Eine Druckerfreigabe wird durch die Funktion „Create SharedPrinter“ erstellt.

Tabelle: Create SharedPrinter

Parameter Beschreibung Datentyp Pflichtparameter
UncPath Spezifiziert den Druckerfreigabepfad Textfeld Ja
ContinueOnError Wenn ein Fehler auftritt, mit der nächsten Funktion fortfahren Wahrheitswert Nein

Abbildung: Create Shared Printer Abbildung: Create Shared Printer

1.11.8.3. Logoff: Delete Printer

Einen bereits verbundenen Drucker zu trennen erfolgt mittels der Funktion „Delete Printer“.

Tabelle: Delete Printer

Parameter Beschreibung Datentyp Pflichtparameter
UncPath Spezifiziert den Druckerfreigabepfad Textfeld Ja
DeletePort Name des Ports für den Drucker Textfeld Nein
ContinueOnError Wenn ein Fehler auftritt, mit der nächsten Funktion fortfahren Wahrheitswert Nein

Abbildung: Delete Printer

Abbildung: Delete Printer

1.11.8.4. Logoff: Set DefaultPrinter

Ein Drucker kann als Standard-Drucker mit der Funktion „Set DefaultPrinter“ hinterlegt werden.

Tabelle: Set DefaultPrinter

Parameter Beschreibung Datentyp Pflichtparameter
Name Name des Druckers Textfeld Ja
ContinueOnError Wenn ein Fehler auftritt, mit der nächsten Funktion fortfahren Wahrheitswert Nein

Abbildung: Set DefaultPrinter

Abbildung: Set DefaultPrinter

1.11.8.5. Logoff: Beispiel - Printer

Beispielhaft wird die Funktion “Create NetworkPrinter” konfiguriert.

Tabelle: Printer Beispielparameter

Parameter Wert des Parameters
Name RISC_Network_Printer
DriverName HP LJ300-400 color MFP M375-M475 PCL6 Class Driver
IpOrDnsAddress 192.55.123.88
PrinterPortName WSD
ContinueOnError Wahr

Abbildung: Beispiel - Printer Abbildung: Beispiel - Printer

Abbildung: Beispiel - Printer

1.11.9. Logoff: Process

Sollten Prozesse bei einem Windows Benutzer Logoff gestartet oder beendet werden, können diese über das Funktionsset „Process“ genutzt werden. Das Funktionsset enthält folgende Funktionen:

  • Run Process
  • End Process

Abbildung: Process

Abbildung: Process

1.11.9.1. Logoff: End Process

Zum Beenden eines Prozesses wird die Funktion „End Process“ genutzt.

Tabelle: End Process

Parameter Beschreibung Datentyp Pflichtparameter
Process Name, Dateiname oder Dateipfad des laufenden Prozesses, welcher beendet werden soll. Textfeld Ja
ContinueOnError Wenn ein Fehler auftritt, mit der nächsten Funktion fortfahren Wahrheitswert Nein

Abbildung: End Process

Abbildung: End Process

1.11.9.2. Logoff: Run Process

Zur Ausführung eines Prozesses können folgende Parameter genutzt werden.

Tabelle: Run Process

Parameter Beschreibung Datentyp Pflichtparameter
FilePath Pfad zur ausführbaren Datei Textfeld Ja
Argument Argumente für die ausführbare Datei Textfeld Nein
WindowStyle Definiert den Stile des Fensters für die ausführbare Datei Listenfeld Nein
WaitForExit Warten, bis der Prozess vollständig beendet wurde Wahrheitswert Nein
PassThru Gibt den Rückgabewert der ausführbaren Datei zurück (Erfolgs- oder Fehlerwert) Wahrheitswert Nein
ContinueOnError Wenn ein Fehler auftritt, mit der nächsten Funktion fortfahren Wahrheitswert Nein

Abbildung: Run Process

Abbildung: Run Process

1.11.9.3. Logoff: Beispiel - Process

Beispielhaft wir die Funktion „Run Process“ in der nachfolgenden Abbildung mit den einzelnen Parametern dargestellt.

Tabelle: Process Beispielparameter

Parameter Wert des Parameters
FilePath %ProgramFiles(x86)%\Microsoft Office\Office16\lync.exe
WindowStyle Normal
WaitForExit Wahr
ContinueOnError Wahr

Abbildung: Run Process Abbildung: Run Process

Abbildung: Run Process

1.11.10. Logoff: Registry

In dem Funktionsset „Registry“ können folgende Funktionen genutzt werden:

  • Export Registry
  • Import Registry
  • Remove RegistryKey
  • Set RegistryKey

Abbildung: Registry

Abbildung: Registry

1.11.10.1. Logoff: Export Registry

Zum Exportieren eines Registry-Keys wird die Funktion „Export Registry“ genutzt.

Tabelle 39: Export Registry

Parameter Beschreibung Datentyp Pflichtparameter
Key Pfad zum Registry-Key Textfeld Ja
ExportFilePath Exportpfad für die .reg Datei Textfeld Ja
ContinueOnError Wenn ein Fehler auftritt, mit der nächsten Funktion fortfahren Wahrheitswert Nein

Abbildung: Export Registry

Abbildung: Export Registry

1.11.10.2. Logoff: Import Registry

Diese Funktion importiert einen Registry-Key.

Tabelle: Import Registry

Parameter Beschreibung Datentyp Pflichtparameter
ImportFilePath Importpfad für die .reg Datei Textfeld Ja
ContinueOnError Wenn ein Fehler auftritt, mit der nächsten Funktion fortfahren Wahrheitswert Nein

Abbildung: Import Registry

Abbildung: Import Registry

1.11.10.3. Logoff: Remove RegistryKey

Zum Löschen eines Registry-Keys wird diese Funktion genutzt.

Tabelle: Remove RegistryKey

Parameter Beschreibung Datentyp Pflichtparameter
Key Pfad zum Registry-Key Textfeld Ja
Name Name des Registry-Key Textfeld Nein
Recurse Alle Unterordner und Dateien kopieren Wahrheitswert Nein
SID Sicherheitsidentifikator (SID) eines Benutzers Textfeld Nein
ContinueOnError Wenn ein Fehler auftritt, mit der nächsten Funktion fortfahren Wahrheitswert Nein

Abbildung: Remove RegistryKey

Abbildung: Remove RegistryKey

1.11.10.4. Logoff: Set RegistryKey

Diese Funktion wird zum Setzen eines Registry-Key benötigt.

Tabelle: Set RegistryKey

Parameter Beschreibung Datentyp Pflichtparameter
Key Pfad zum Registry-Key Textfeld Ja
ValueName Name des Werts Textfeld Nein
TargetValue Daten mit denen der Wert gefüllt werden soll Textfeld Nein
ExpectedValue Der erwartete Wert, damit festgestellt werden kann, ob der Wert vom Benutzer geändert wurde Textfeld Nein
Type Wert des Registry Schlüssels (Binary, Dword, ExpandString, usw.) Listenfeld Nein
CreateKey Abfrage, ob der Schlüssel erzeugt werden soll, wenn er nicht existiert Wahrheitswert Nein
AllowUserChange Spezifiziert ob der Wert behalten werden soll, wenn er durch den Benutzer geändert wurde Textfeld Nein
ContinueOnError Wenn ein Fehler auftritt, mit der nächsten Funktion fortfahren Wahrheitswert Nein

Abbildung: Set RegistryKey

Abbildung: Set RegistryKey

1.11.10.5. Logoff: Beispiel - Registry

Als Beispiel zum Funktionsset Registry wird ein Registry-Key gesetzt.

Tabelle: Registry Beispielparameter

Parameter Wert des Parameters
Key HKEY_CURRENT_USER\SOFTWARE\Adobe\Acrobat Reader\DC\AdobeViewer
ValueName Eula
TargetValue 1
Type DWord
ContinueOnError Wahr

Abbildung: Beispiel Registry Abbildung: Beispiel Registry

Abbildung: Beispiel Registry

1.11.11. Logoff: Script

Das Funktionsset „Script“ umfasst folgende Funktionen:

  • Execute Script
  • Execute ScriptCommand

Abbildung: Script

Abbildung: Script

1.11.11.1. Logoff: Execute Script

Ein PowerShell Skript kann mittels der Funktion „Execute Script“ ausgeführt werden.

Tabelle: Execute Script

Parameter Beschreibung Datentyp Pflichtparameter
Path Pfad zum PowerShell Skript Textfeld Ja
Parameter Parameter, die an das Zielskript übergeben werden Textfeld Nein
ContinueOnError Name des Registry-Key Wahrheitswert Nein

Abbildung: ExecuteScript

Abbildung: ExecuteScript

1.11.11.2. Logoff: Execute ScriptCommand

Diese Funktion ermöglicht die Ausführung eines Script Command.

Tabelle: Execute ScriptCommand

Parameter Beschreibung Datentyp Pflichtparameter
Command PowerShell Script Command Textfeld Ja
ContinueOnError Name des Registry-Key Wahrheitswert Nein

Abbildung: Execute ScriptCommand

Abbildung: Execute ScriptCommand

1.11.11.3. Logoff: Beispiel - Script

Beispielhaft wird die Funktion “Execute Script” konfiguriert.

Tabelle: Script Beispielparameter

Parameter Wert des Parameters
Path %ProgramFiles%\RISC_Software\PowerShell_Profile_Management\Framework\Deploy-UserPackage.ps1
ContinueOnError Wahr

Abbildung: Beispiel Script Abbildung: Beispiel Script

Abbildung: Beispiel Script