Automatisierung > PowerShell-Modul

Bestimmte Aktionen für Datenbank und Pakete werden über das RayQC Advanced-PowerShell-Modul bereitgestellt.

Um zu beginnen, stellen Sie sicher, dass das Modul importiert wurde. Führen Sie den folgenden Befehl in einem PowerShell-Terminal Ihrer Wahl aus:

Import-Module "<RayQCAdvancedInstallDir>\Libs\Raynet.RayQCAd.Common.Automation.dll"

Sie können die verfügbaren Befehle anzeigen, indem Sie folgenden PowerShell-Code ausführen:

(Get-module Raynet.RayQCAd.Common.Automation).ExportedCommands

Import-Package

Importiert das angegebene Paket in die Softwarebibliothek.

Name	Type	Mandatory	Description
ExtractFiles	Boolean	No	Ein boolescher Wert, der angibt, ob die Dateien beim Import extrahiert werden sollen (empfohlen).
File	FileInfo	Yes	Die zu importierende Datei (z. B. eine MSI-Datei).
Folder	String	No	Der Pfad in der Softwarebibliothek, in den das Paket importiert werden soll.
Name	String	No	Der neue Paketname des importierten Pakets.
Package	PSPackage	Yes	Die Instanz des PSPackage-Objekts (für den erneuten Import).
Transforms	FileInfo[]	No	Eine optionale Liste von Transforms, die beim Import angewendet werden sollen.
Vendor	String	No	Der neue Herstellername des importierten Pakets.
Version	Version	No	Der neue Versionsname des importierten Pakets.

Gibt ein PSPackage-Objekt mit dem neu importierten Paket zurück.

Get-Package

Ruft eine Sammlung von PSPackage-Objekten aus einem angegebenen Dateipfad oder aus der Bibliothek ab.

Name	Type	Mandatory	Description
Path	FileInfo	No	Der Pfad zu einer lokalen Datei.
Transforms	FileInfo[]	No	Eine optionale Liste von Transforms (lokale Dateien). Dies gilt nur für den Import von MSI-Paketen.
LibraryPath	String	No	Der Pfad in der Softwarebibliothek
Id	Integer	No	Der interne Paketbezeichner.
All	Switch	No	Wenn gesetzt, werden alle Pakete aus der Bibliothek zurückgegeben.

Gibt eine Sammlung von PSPackage-Objekten zurück.

Get-Rule

Ruft eine Sammlung von PSRule-Regeln aus der Datenbank ab.

Name	Type	Mandatory	Description
RuleId	String	No	Der Name der Regel gemäß der RayQC Advanced-Namenskonvention, z. B. TG* oder TA-001-TA018.
RuleSetName	String	No	Der vollständige Name des Regelsatzes.
All	Switch	No	Wenn gesetzt, werden alle Regeln aus der Bibliothek zurückgegeben.

Gibt eine Sammlung von PSRule-Objekten zurück.

Start-Test

Führt eine Reihe von Tests mit der angegebenen Menge an Paketen und Regeln durch.

Name	Type	Mandatory	Description
Rules	PsRule[]	Yes	Die auszuführenden Regeln. Sie können diese mit dem Befehl Get-Rule abrufen.
Source	PSPackage[]	Yes	Die Sammlung der zu testenden Quellpakete.
Target	PsPackage[]	No	Die Sammlung der Zielpakete. Dies gilt nur für Konflikterkennung.
Name	String	No	Der Name des Berichts
Comment	String	No	Der dem Bericht hinzuzufügende Kommentar.
DoNotAddToDatabase	Switch	No	Wenn gesetzt, werden die Prüfungen im passiven Modus ausgeführt, d. h. die Ergebnisse werden nicht in der Datenbank gespeichert. Die Ergebnisse müssen selbst gespeichert werden.

Gibt die Ergebnisse eines angegebenen Tests zurück, die in einem PSTestResult-Objekt gekapselt sind.

Export-Report

Exportiert einen Bericht aus der Ergebnissammlung (die in einem Objekt vom Typ PSTestResult enthalten ist) und speichert ihn in einem angegebenen Format.

Name	Type	Mandatory	Description
TestResult	PSTestResult[]	Yes	Die Sammlung der Testergebnisse. Sie können diese durch Aufrufen des Befehls Start-Test abrufen.
Format	Enum	No	Das Berichtsformat.
Path	String	No	Der Pfad, unter dem der Bericht gespeichert werden soll.
IncludeIssueDetails	Bool	No	Ein boolescher Wert, der bestimmt, ob die Problemdetails in der Ausgabedatei enthalten sein sollen.
IncludeRuleDetails	Bool	No	Ein boolescher Wert, der bestimmt, ob die Regeldetails in der Ausgabedatei enthalten sein sollen.
IncludeCustomFields	Bool	No	Ein boolescher Wert, der bestimmt, ob die benutzerdefinierten Felder in der Ausgabedatei enthalten sein sollen.
IncludePackageInformation	Bool	No	Ein boolescher Wert, der bestimmt, ob die Paketinformationen in der Ausgabedatei enthalten sein sollen.

Gibt eine Instanz des FileInfo-Objekts zurück, das die exportierte Datei repräsentiert.

Remove-Package

Entfernt ein Paket aus der Bibliothek.

Name	Type	Mandatory	Description
Package	PSPackage	Yes	Das zu entfernende Paket.

Remove-Report

Entfernt einen Bericht aus der Bibliothek.

Name	Type	Mandatory	Description
TestResult	PSTestResult	False	Die Instanz des PSTestResult-Objekts.
ReportId	Integer	False	Der interne Bezeichner eines Berichts.

Start-AutoRemediation

Führt eine automatische Problembehebung (wenn anwendbar) für bestimmte Testergebnisse durch.

Name	Type	Mandatory	Description
TestResult	PSTestResult	Yes	Die Instanz, die die Testergebnisse repräsentiert. Sie können diese mit dem Befehl Start-Test abrufen.
RulesToFix	PSRule[]	No	Die Sammlung der automatisch zu behebenden Regeln. Sie können diese mit dem Befehl Get-Rule abrufen.
FixMode	Enum	No	Wenn anwendbar, legt den bevorzugten Typ der Problembehebung fest. Wählen Sie zwischen folgenden Werten: Light Power Ignore

Gibt die Ergebnisse eines angegebenen Tests zurück, die in einem PSTestResult-Objekt gekapselt sind.