Das ist eine für den Ausdruck optimierte Ansicht des gesamten Kapitels inkl. Unterseiten. Druckvorgang starten.

Über diese Dokumentation

1: Übersicht
2: Betriebsempfehlungen
3: Fehlerbehebung
4: Modulbefehle Referenz

4.1: Add-PackageUpdateRule
4.2: Export-PackageUpdateInfo
4.3: Get-PackageUpdateInfo
4.4: Get-PackageUpdateRule
4.5: Get-PackageUpdateSetting
4.6: Import-PackageUpdateInfo
4.7: Remove-PackageUpdateRule
4.8: Set-PackageUpdateRule
4.9: Set-PackageUpdateSetting
4.10: Show-PackageUpdateReleaseNote

Dies ist die offizielle Dokumentationsseite für PackageUpdateInfo, ein PowerShell-Modul, das dir dabei hilft, den Überblick über deine installierten Module zu behalten, indem es alle lokal installierten PowerShell-Module überprüft und anzeigt, welche aktualisiert werden müssen.

Über das Modul

PackageUpdateInfo entstand aus einem echten Bedarf: Es ist mühsam und leicht, den Überblick über Updates von vielen installierten PowerShell-Modulen zu verlieren. Dieses Modul schließt diese Lücke, indem es automatisch alle installierten Module mit der PowerShell-Galerie vergleicht und eine klare Übersicht über verfügbare Updates bietet.

Wichtige Designprinzipien:

Plattformübergreifend — unterstützt Windows, Linux und macOS
Kompatibilität über Editionen hinweg — unterstützt PowerShell Desktop (5.1+) und Core (7.x)
Anpassbar — passe die Intervalle für die Update-Prüfung, Regeln für Versionssensitivität und Ausschlüsse an
Pipeline-freundlich — integriert sich nahtlos in die Pipeline-Architektur von PowerShell
Benachrichtigungsunterstützung — optional BurntToast-Desktop-Benachrichtigungen unter Windows

Ressourcen

GitHub: https://github.com/AndiBellstedt/PackageUpdateInfo
PowerShell Gallery: https://www.powershellgallery.com/packages/PackageUpdateInfo
Autor-Blog: https://andibellstedt.com

Mitwirken

Beiträge sind willkommen. Wenn du Probleme, Fehler findest oder Verbesserungsvorschläge hast, öffne bitte ein Issue oder einen Pull-Request im GitHub-Repository.

1 - Übersicht

PackageUpdateInfo hilft dir, installierte PowerShell-Module auf dem neuesten Stand zu halten. Es vergleicht lokale Modulversionen mit Versionen aus konfigurierten Online-Repositorys (zum Beispiel PSGallery) und meldet, wenn neuere Versionen verfügbar sind.

Was macht PackageUpdateInfo?

Das Modul kann:

Lokale installierte Module abfragen.
Aktuelle Online-Versionen entdecken.
Versionen mit anpassbarer Empfindlichkeit vergleichen (major, minor, build, revision).
Umfangreiche Ausgaben anzeigen, inklusive Repository, Versionshinweisen, Autor und Projektlinks.
Ergebnisse für späteren Import und schnelle Start-Workflows exportieren.

Warum PackageUpdateInfo verwenden?

Komfort

Schnelles Erkennen veralteter Module ohne manuelles Überprüfen.
Update-Informationen für Offline- oder verzögerte Überprüfung exportieren und importieren.
Update-Checks im Hintergrund ausführen.
Optionale Toast-Benachrichtigungen unter Windows nutzen.

Automatisierung

Update-Checks mit deinem Profil, geplanten Tasks oder Startroutinen planen.
Ein Update-Check-Intervall festlegen, um unnötige Repository-Abfragen zu vermeiden.
Benutzerdefinierte Regeln pro Modulpattern für die Update-Empfindlichkeit festlegen.
Bereits exportierte Daten für eine niedrige Latenz beim Shell-Start wiederverwenden.

Flexibilität

Modulnamensmuster ein- oder ausschließen.
Regelbereich und Priorität mit Standard- und benutzerdefinierten Regeln definieren.
Funktioniert unter Windows, Linux und macOS.
Unterstützt Windows PowerShell 5.1 und PowerShell 7+.

Voraussetzungen

Windows PowerShell 5.1 oder PowerShell 7+.
PowerShellGet Zugriff auf dein Ziel-Repository (z.B. PSGallery).
Optional: BurntToast-Modul für Toast-Benachrichtigungen unter Windows.

Installation

Für alle Benutzer installieren (benötigt Administratorrechte):

Install-Module PackageUpdateInfo

Für den aktuellen Benutzer installieren:

Install-Module PackageUpdateInfo -Scope CurrentUser

Schneller Einstieg

Führe eine interaktive Überprüfung durch:

Get-PackageUpdateInfo

Zeige nur Module an, die ein Update benötigen:

Get-PackageUpdateInfo -ShowOnlyNeededUpdate

Erzwinge eine Überprüfung, auch wenn das konfigurierte Update-Intervall noch nicht abgelaufen ist:

Get-PackageUpdateInfo -Force

Verwende Toast-Benachrichtigungen (Windows mit BurntToast):

Get-PackageUpdateInfo -ShowToastNotification

Praktisches Automatisierungsmuster

Exportiere Update-Daten in einem Hintergrund-Job und importiere sie beim Shell-Start:

Start-Job -ScriptBlock { Get-PackageUpdateInfo -ShowOnlyNeededUpdate -ShowToastNotification | Export-PackageUpdateInfo } | Out-Null
Import-PackageUpdateInfo

Das hält den Start interaktiv, während aktuelle Update-Informationen angezeigt werden.

Nächste Schritte

Weiter mit Best Practices für Betrieb, Regelgestaltung und Automatisierung.
Weiter mit Troubleshooting für häufige Fehler und Wiederherstellungsprozesse.

2 - Betriebsempfehlungen

Diese Seite beschreibt empfohlene Betriebsabläufe für PackageUpdateInfo in interaktiven Shells, Profilen und Automatisierungen.

Beginne mit dem Standardverhalten

Setze die Einstellungen zurück, bevor du benutzerdefinierte Anpassungen vornimmst, insbesondere auf gemeinsam genutzten Systemen:

Set-PackageUpdateSetting -Reset

Prüfe die aktuelle Konfiguration und Regeln:

Get-PackageUpdateSetting
Get-PackageUpdateRule -IncludeDefaultRule

Nutze Update-Intervalle, um Rauschen zu reduzieren

Get-PackageUpdateInfo respektiert UpdateCheckInterval. Wenn die letzte effektive Überprüfung noch innerhalb des konfigurierten Intervalls liegt, gibt das Cmdlet frühzeitig zurück.

Lege ein Intervall fest, das zu deiner Umgebung passt:

Set-PackageUpdateSetting -UpdateCheckInterval (New-TimeSpan -Hours 6)

Verwende -Force nur für ad-hoc Überprüfungen:

Get-PackageUpdateInfo -Force

Bevorzuge nicht-blockierende Shell-Starts

Ein praktisches Profilmuster ist:

Start-Job -ScriptBlock {
    Get-PackageUpdateInfo -ShowOnlyNeededUpdate | Export-PackageUpdateInfo
} | Out-Null

Import-PackageUpdateInfo

Warum das gut funktioniert:

Der Start bleibt schnell, weil der Import zwischengespeicherte Daten liest.
Die aufwändige Online-Überprüfung läuft im Hintergrund.
Du erhältst in jeder Sitzung eine nützliche Übersicht über Updates.

Überprüfungen explizit bei Bedarf einschränken

Verwende Scope-Parameter, wenn Berechtigungen zwischen Benutzer- und Systemmodulen unterschiedlich sind:

Get-PackageUpdateInfo -CurrentUser
Get-PackageUpdateInfo -AllUsers

Nutze -Repository in Umgebungen mit mehreren konfigurierten Repositories:

Get-PackageUpdateInfo -Repository PSGallery

Regeln sorgfältig entwerfen

Verwende breite Ausschlüsse nur, wenn es beabsichtigt ist. Das Ausschließen großer Muster kann wichtige Updates verbergen.

Erstelle fokussierte, benutzerdefinierte Regeln für Module mit hoher Änderungsrate:

Add-PackageUpdateRule -IncludeModuleForChecking "Az.*" -ReportChangeOnMajor $true -ReportChangeOnMinor $true -ReportChangeOnBuild $false -ReportChangeOnRevision $false

Überprüfe die Priorität der Regeln, indem du alle Regeln auflistest:

Get-PackageUpdateRule -IncludeDefaultRule | Sort-Object Id

Exportieren/Importieren gezielt einsetzen

Standardpfade für Export und Import sind plattformspezifisch und enthalten PowerShell-Edition sowie die Hauptversion im Dateinamen. Das hilft, Daten verschiedener Laufzeiten nicht zu vermischen.

Gängige Exportoptionen:

Get-PackageUpdateInfo | Export-PackageUpdateInfo -OutputFormat XML
Get-PackageUpdateInfo | Export-PackageUpdateInfo -OutputFormat JSON
Get-PackageUpdateInfo | Export-PackageUpdateInfo -OutputFormat CSV

Empfohlene Vorgehensweise:

Verwende XML, wenn du typisierte Objekte für einen erneuten Import bewahren möchtest.
Nutze JSON oder CSV für externe Berichte und Integrationen.
Nutze -IncludeTimeStamp für eine historische Nachverfolgung.

Benachrichtigungen sinnvoll nutzen

Verwende Toast-Benachrichtigungen nur dort, wo sie Mehrwert bieten:

Auf Windows-Hosts mit installiertem BurntToast.
Bei Sitzungen, in denen interaktive Warnungen erwartet werden.

Für Server, CI und nicht-interaktive Shells bevorzugst du exportierte Berichte gegenüber Toast-Benachrichtigungen.

3 - Fehlerbehebung

Verwende diese Anleitung, wenn PackageUpdateInfo keine erwarteten Ergebnisse liefert, Prüfungen überspringt oder beim Import und Export von Daten fehlschlägt.

Erste Schritte: Aktionsfähige Diagnosen

Führe den Befehl mit ausführlicher Ausgabe aus:

Get-PackageUpdateInfo -Verbose

Einstellungen und Regeln prüfen:

Get-PackageUpdateSetting
Get-PackageUpdateRule -IncludeDefaultRule

Wird übersprungen unerwartet?

Symptom:

Du siehst eine Warnung, dass Update-Prüfungen übersprungen werden, weil das Prüfintervall noch nicht abgelaufen ist.

Ursache:

UpdateCheckInterval und das aktuelle LastCheck oder LastSuccessfulCheck verhindern eine neue Online-Prüfung.

Lösung:

Get-PackageUpdateInfo -Force

Oder das Intervall verkürzen:

Set-PackageUpdateSetting -UpdateCheckInterval (New-TimeSpan -Minutes 30)

Konfigurationsdatei fehlt oder ist beschädigt

Symptom:

Get-PackageUpdateSetting warnt, dass die Modulkonfigurationsdatei nicht gefunden wurde, und wirft dann einen Fehler.

Ursache:

Der Pfad zur Konfigurationsdatei existiert nicht oder enthält ungültiges JSON.

Lösung:

Set-PackageUpdateSetting -Reset
Get-PackageUpdateSetting

Keine Module werden zurückgegeben

Symptom:

Get-PackageUpdateInfo liefert nichts, obwohl Module installiert sind.

Häufige Ursachen:

Include- und Exclude-Regeln filtern alle Module heraus.
-CurrentUser oder -AllUsers filtern die erwarteten Module aus.
Repository-Filterung schließt relevante Module aus.

Schritte zur Lösung:

Get-PackageUpdateRule -IncludeDefaultRule
Get-PackageUpdateInfo -Force
Get-PackageUpdateInfo -CurrentUser -Force
Get-PackageUpdateInfo -AllUsers -Force

Export schlägt wegen Pfadfehlern fehl

Symptom:

Export meldet ungültigen Pfad oder Verzeichnisprobleme.

Ursache:

-Path zeigt auf ein Verzeichnis oder einen nicht existierenden Ort ohne -Force.

Lösung:

Get-PackageUpdateInfo | Export-PackageUpdateInfo -Path "$HOME\PackageUpdateInfo\updates.xml" -Force

Import liefert keine Daten

Symptom:

Import-PackageUpdateInfo liefert nichts.

Häufige Ursachen:

Die Datei ist leer oder zu klein, um Datensätze zu enthalten.
-InputFormat stimmt nicht mit dem exportierten Format überein.
Falscher Dateipfad für die aktuelle Laufzeit und Edition.

Lösung:

Import-PackageUpdateInfo -InputFormat XML -Verbose
Import-PackageUpdateInfo -Path "$HOME\PackageUpdateInfo\updates.json" -InputFormat JSON

Toast-Benachrichtigungen erscheinen nicht

Symptom:

-ShowToastNotification wird verwendet, aber kein Toast erscheint.

Häufige Ursachen:

BurntToast ist nicht installiert.
Die Host-Plattform unterstützt keine Windows-Toast-Benachrichtigungen.
Kein Modul im Ergebnis hat NeedUpdate = $true.

Lösung:

Install-Module BurntToast -Scope CurrentUser
Get-PackageUpdateInfo -ShowOnlyNeededUpdate -ShowToastNotification -Force

Regeln können nicht hinzugefügt oder geändert werden

Symptom:

Das Hinzufügen einer Regel schlägt mit doppelter Id, include oder exclude fehl.

Ursache:

Bereits vorhandene benutzerdefinierte Regeln enthalten die gleichen Identifikatoren oder Muster.

Lösung:

Get-PackageUpdateRule
Add-PackageUpdateRule -IncludeModuleForChecking "MyModule.*"
Set-PackageUpdateRule -Id 1 -ReportChangeOnRevision $false
Remove-PackageUpdateRule -Id 1

Repository- und Netzwerkprobleme

Symptom:

Online-Versionenabfrage schlägt fehl oder ist unvollständig.

Häufige Ursachen:

Repository ist nicht registriert oder nicht erreichbar.
Vorübergehende Netzwerkprobleme.

Lösung:

Get-PSRepository
Find-Module PackageUpdateInfo -Repository PSGallery
Get-PackageUpdateInfo -Repository PSGallery -Force

Wiederherstellungsablauf

Wenn das Verhalten weiterhin inkonsistent ist, nutze diese Reset-Sequenz:

Set-PackageUpdateSetting -Reset
Get-PackageUpdateInfo -Force | Export-PackageUpdateInfo
Import-PackageUpdateInfo

4 - Modulbefehle Referenz

Hier findest du eine Referenz für alle Befehle im Modul. Diese Referenz soll dir helfen, schnell den Befehl zu finden, den du brauchst, und zu verstehen, wie du ihn effektiv nutzt.

Wenn du auf einen Befehl klickst, gelangst du zu einer detaillierten Seite, die umfassende Informationen über den Befehl bietet, einschließlich seiner Syntax, Parameter, Beispiele und zusätzlicher Hinweise oder Tipps zur Verwendung.

4.1 - Add-PackageUpdateRule

SYNOPSIS

Fügt eine benutzerdefinierte Regel hinzu, die steuert, wie Modul-Updates gemeldet werden.

SYNTAX

__AllParameterSets

Add-PackageUpdateRule [[-Id] <int>] [[-IncludeModuleForChecking] <string[]>]
 [[-ExcludeModuleFromChecking] <string[]>] [[-ReportChangeOnMajor] <bool>]
 [[-ReportChangeOnMinor] <bool>] [[-ReportChangeOnBuild] <bool>] [[-ReportChangeOnRevision] <bool>]
 [[-SettingObject] <Configuration>] [-PassThru] [-WhatIf] [-Confirm] [<CommonParameters>]

ALIASES

Dieses Cmdlet hat folgende Aliase,

BESCHREIBUNG

Dieser Befehl erstellt eine benutzerdefinierte Update-Regel für die aktuelle PackageUpdateInfo-Konfiguration. Jede Regel definiert, wann ein Update als relevant für die Meldung betrachtet wird, basierend auf Änderungen im Major-, Minor-, Build- oder Revision-Teil der Modulversion. Regeln können die Meldung auch auf bestimmte Module beschränken, indem Modulnamen ein- oder ausgeschlossen werden, was es ermöglicht, störende reine Revisions-Updates zu unterdrücken oder Prüfungen auf ausgewählte Module zu fokussieren. Wenn kein Einstellungsobjekt angegeben wird, verwendet der Befehl die aktuelle Modulkonfiguration und speichert die neue Regel dort.

BEISPIELE

BEISPIEL 1

PS C:\> Add-PackageUpdateRule -IncludeModuleForChecking "MyModule" -ReportChangeOnMajor $true -ReportChangeOnMinor $true -ReportChangeOnBuild $true -ReportChangeOnRevision $false

Fügt eine Regel hinzu, die Major-, Minor- und Build-Updates für MyModule meldet, während reine Revisionsänderungen unterdrückt werden.

BEISPIEL 2

PS C:\> Add-PackageUpdateRule -ExcludeModuleFromChecking "PowerShellGet","PSScriptAnalyzer" -ReportChangeOnRevision $false

Fügt eine Regel hinzu, die zwei Module von der Update-Prüfung ausschließt und Revisions-Updates für die übrigen Module unterdrückt.

BEISPIEL 3

PS C:\> Add-PackageUpdateRule -Id 99 -IncludeModuleForChecking "MyModule" -PassThru

Fügt eine Regel mit einer spezifischen Kennung hinzu und gibt das erstellte Regelobjekt zurück.

BEISPIEL 4

PS C:\> $settings = Get-PackageUpdateSetting; Add-PackageUpdateRule -SettingObject $settings -ExcludeModuleFromChecking "MyModule"

Fügt einem bestehenden Einstellungsobjekt eine Regel hinzu, ohne die Standard-Modulkonfiguration zu verwenden.

PARAMETER

-Confirm

Fordert eine Bestätigung an, bevor die neue Regel gespeichert wird.

Type: SwitchParameter
DefaultValue: ''
SupportsWildcards: false
Aliases:
- cf
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-ExcludeModuleFromChecking

Ein oder mehrere Modulnamen, die von der Update-Prüfung durch diese Regel ausgeschlossen werden sollen.

Type: String[]
DefaultValue: ''
SupportsWildcards: false
Aliases:
- Exclude
- ExcludeModule
ParameterSets:
- Name: (All)
  Position: 2
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Id

Die eindeutige Kennung für die Regel.

Type: Int32
DefaultValue: 0
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: 0
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-IncludeModuleForChecking

Ein oder mehrere Modulnamen, die von dieser Regel in die Update-Prüfung einbezogen werden sollen. Wird dieser Parameter weggelassen, gilt die Regel für alle Module.

Type: String[]
DefaultValue: ''
SupportsWildcards: false
Aliases:
- Include
- IncludeModule
ParameterSets:
- Name: (All)
  Position: 1
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-PassThru

Gibt das erstellte Regelobjekt über die Pipeline zurück.

Type: SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-ReportChangeOnBuild

Gibt an, ob eine Änderung im Build-Versionsanteil eine Update-Meldung auslösen soll.

Das bedeutet, dass ‘Get-PackageUpdateSetting’ nur dann ein Update meldet, wenn sich die Build-Version eines Moduls ändert. Major Minor Build Revision

0 0 1 0

Type: Boolean
DefaultValue: True
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: 5
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-ReportChangeOnMajor

Gibt an, ob eine Änderung im Major-Versionsanteil eine Update-Meldung auslösen soll.

Das bedeutet, dass ‘Get-PackageUpdateSetting’ nur dann ein Update meldet, wenn sich die Major-Version eines Moduls ändert.

Major Minor Build Revision

1 0 0 0

Type: Boolean
DefaultValue: True
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: 3
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-ReportChangeOnMinor

Gibt an, ob eine Änderung im Minor-Versionsanteil eine Update-Meldung auslösen soll.

Das bedeutet, dass ‘Get-PackageUpdateSetting’ nur dann ein Update meldet, wenn sich die Minor-Version eines Moduls ändert.

Major Minor Build Revision

0 1 0 0

Type: Boolean
DefaultValue: True
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: 4
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-ReportChangeOnRevision

Gibt an, ob eine Änderung im Revisions-Versionsanteil eine Update-Meldung auslösen soll.

Das bedeutet, dass ‘Get-PackageUpdateSetting’ eine Update-Meldung ausgibt, wenn sich die Revisions-Version eines Moduls ändert.

Major Minor Build Revision

0 0 0 1

Type: Boolean
DefaultValue: True
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: 6
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-SettingObject

Ein Einstellungsobjekt von Get-PackageUpdateSetting, das die neue Regel erhalten soll. Wird dieser Parameter weggelassen, werden die aktuellen Moduleinstellungen verwendet.

Type: Configuration
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: 7
  IsRequired: false
  ValueFromPipeline: true
  ValueFromPipelineByPropertyName: true
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-WhatIf

Zeigt an, was passieren würde, wenn der Befehl ausgeführt wird, ohne die Konfiguration zu ändern.

Type: SwitchParameter
DefaultValue: ''
SupportsWildcards: false
Aliases:
- wi
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

EINGABEN

PackageUpdate.Configuration

AUSGABEN

PackageUpdate.ModuleRule

HINWEISE

Version : 1.1.0.0 Autor : Andi Bellstedt Datum : 2026-06-21 Schlüsselwörter : PackageUpdateInfo, Update, Modul, Regel

4.2 - Export-PackageUpdateInfo

SYNOPSIS

Exportiert PackageUpdateInfo-Objekte in eine XML-, JSON- oder CSV-Datei.

SYNTAX

__AllParameterSets

Export-PackageUpdateInfo [[-Path] <string>] -InputObject <Info[]> [-OutputFormat <string>]
 [-Encoding <string>] [-Force] [-Append] [-IncludeTimeStamp] [-PassThru] [-WhatIf] [-Confirm]
 [<CommonParameters>]

ALIASES

Dieses Cmdlet hat die folgenden Aliase,

BESCHREIBUNG

Schreibt PackageUpdateInfo-Objekte, die von Get-PackageUpdateInfo erzeugt wurden, in eine strukturierte Datendatei zur Persistenz, Berichterstattung oder späteren Automatisierung. Das Cmdlet unterstützt die Ausgabeformate XML, JSON und CSV, optionales Zeitstempeln und den Anfügemodus zum Erweitern einer bestehenden Datei. Es unterstützt außerdem das Erstellen des Zielverzeichnisses bei Bedarf und kann die exportierten Objekte zurück über die Pipeline senden.

BEISPIELE

BEISPIEL 1

PS C:\> Get-PackageUpdateInfo | Export-PackageUpdateInfo

Exportiert die aktuellen PackageUpdateInfo-Objekte in die Standard-XML-Datei.

BEISPIEL 2

PS C:\> Get-PackageUpdateInfo | Export-PackageUpdateInfo -OutputFormat JSON -Path .\updates.json -IncludeTimeStamp -PassThru

Exportiert die Daten als JSON, fügt für jeden Datensatz einen Zeitstempel hinzu und gibt die Objekte über die Pipeline weiter.

BEISPIEL 3

PS C:\> Get-PackageUpdateInfo | Export-PackageUpdateInfo -OutputFormat CSV -Path .\updates.csv -Append -Force

Hängt die exportierten Daten an eine CSV-Datei an und erstellt das Zielverzeichnis, falls es nicht existiert.

BEISPIEL 4

PS C:\> Get-PackageUpdateInfo | Export-PackageUpdateInfo -Path C:\Temp\PackageUpdateInfo.xml -Encoding utf8

Exportiert die aktuellen Daten in eine benutzerdefinierte XML-Datei mit UTF-8-Codierung.

PARAMETER

-Append

Fügt exportierte Informationen an eine bestehende Datei an, anstatt deren aktuellen Inhalt zu ersetzen. Dies wird für JSON- und CSV-Ausgaben unterstützt und bei XML-Ausgaben ignoriert.

Type: SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Confirm

Wenn dieser Schalter aktiviert ist, wirst du vor der Ausführung einer zustandsändernden Operation um Bestätigung gebeten.

Type: SwitchParameter
DefaultValue: ''
SupportsWildcards: false
Aliases:
- cf
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Encoding

Die zu verwendende Dateicodierung beim Erstellen oder Aktualisieren der Exportdatei.

Type: String
DefaultValue: default
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Force

Erstellt das übergeordnete Verzeichnis für die Zieldatei, wenn es noch nicht existiert und der angegebene Pfad außerhalb des Standardorts liegt.

Type: SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-IncludeTimeStamp

Fügt jedem exportierten Datensatz eine TimeStamp-Eigenschaft hinzu, sodass der Exportzeitpunkt für jeden Eintrag erfasst wird.

Type: SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-InputObject

Ein oder mehrere PackageUpdateInfo-Objekte zum Exportieren. Dieser Parameter akzeptiert Pipeline-Eingaben von Get-PackageUpdateInfo und ähnlichen Befehlen.

Type: Info[]
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: true
  ValueFromPipeline: true
  ValueFromPipelineByPropertyName: true
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-OutputFormat

Das für den Export verwendete Ausgabeformat. Unterstützte Werte sind “XML”, “JSON” und “CSV”.

Type: String
DefaultValue: XML
SupportsWildcards: false
Aliases:
- Format
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-PassThru

Sendet die exportierten Objekte nach dem Schreiben auf die Festplatte an die Pipeline weiter.

Type: SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Path

Der Ziel-Dateipfad für die exportierten Daten. Gib einen Dateipfad an, keinen Verzeichnispfad.

Standardpfad ist: Linux: “$HOME/.config/powershell/PackageUpdateInfo/PackageUpdateInfo_$($PSEdition)$($PSVersionTable.PSVersion.Major).xml” Windows: “$HOME\AppData\Local\Microsoft\Windows\PowerShell\PackageUpdateInfo$($PSEdition)_$($PSVersionTable.PSVersion.Major).xml”

Type: String
DefaultValue: ''
SupportsWildcards: false
Aliases:
- FullName
- FilePath
ParameterSets:
- Name: (All)
  Position: 0
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-WhatIf

Wenn dieser Schalter aktiviert ist, werden keine Aktionen ausgeführt, sondern nur Informationsmeldungen angezeigt, die erklären, was passieren würde, wenn der Befehl ausgeführt würde.

Type: SwitchParameter
DefaultValue: ''
SupportsWildcards: false
Aliases:
- wi
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

CommonParameters

EINGABEN

PackageUpdate.Info[]

AUSGABEN

PackageUpdate.Info

HINWEISE

Version : 1.1.0.0 Autor : Andi Bellstedt Datum : 2026-06-21 Schlüsselwörter : PackageUpdateInfo, Update, Modul, Export

4.3 - Get-PackageUpdateInfo

SYNOPSIS

Ruft Update-Informationen für installierte PowerShell-Module ab und identifiziert Module, für die online neuere Versionen verfügbar sind.

SYNTAX

DefaultSet1 (Standard)

Get-PackageUpdateInfo [-Name <string[]>] [-Repository <string[]>] [-ShowOnlyNeededUpdate]
 [-ShowToastNotification] [-Force] [<CommonParameters>]

CurrentUser

Get-PackageUpdateInfo [-Name <string[]>] [-Repository <string[]>] [-ShowOnlyNeededUpdate]
 [-ShowToastNotification] [-CurrentUser] [-Force] [<CommonParameters>]

AllUsers

Get-PackageUpdateInfo [-Name <string[]>] [-Repository <string[]>] [-ShowOnlyNeededUpdate]
 [-ShowToastNotification] [-AllUsers] [-Force] [<CommonParameters>]

ALIASES

Dieses Cmdlet hat die folgenden Aliase,

BESCHREIBUNG

Get-PackageUpdateInfo untersucht lokal installierte PowerShell-Module, vergleicht deren installierte Versionen mit den in einem oder mehreren konfigurierten Repositories verfügbaren Versionen und gibt detaillierte Update-Informationen zurück.

Der Befehl kann die Ergebnisse auf Module filtern, die Updates benötigen, die Suche auf Modulpfade des aktuellen Benutzers oder aller Benutzer einschränken und optional Windows-Toast-Benachrichtigungen anzeigen, wenn Updates verfügbar sind.

Er berücksichtigt außerdem die Update-Prüfregeln des Moduls und das konfigurierte Update-Prüfintervall, sofern du nicht explizit eine frische Prüfung erzwingst.

Die Prüfung erfolgt über PowerShellGet v2 oder v3, abhängig von der Verfügbarkeit des Moduls Microsoft.PowerShell.PSResourceGet im System.

BEISPIELE

BEISPIEL 1

PS C:\> Get-PackageUpdateInfo

Ruft Update-Informationen für alle Module ab, die anhand der konfigurierten Einschlussregeln und verfügbaren Repositories gefunden werden. Die Ausgabe zeigt die installierte Version, die neueste Online-Version und ob ein Update benötigt wird. Die Ausgabe kann so aussehen:

Name Repository VersionInstalled VersionOnline NeedUpdate Path

PSReadline PSGallery 1.2 1.2 False C:\Program Files\WindowsPowerShell\Modules\PSReadline Pester PSGallery 4.4.0 4.4.2 True C:\Program Files\WindowsPowerShell\Modules\Pester

BEISPIEL 2

PS C:\> Get-PackageUpdateInfo -ShowOnlyNeededUpdate

Gibt nur jene Module zurück, für die online eine neuere Version verfügbar ist, sodass du dich leichter auf die Module konzentrieren kannst, die tatsächlich Aufmerksamkeit benötigen. Dies filtert die Ausgabe, sodass nur Module angezeigt werden, bei denen NeedUpdate True ist. Die Ausgabe kann so aussehen:

Name Repository VersionInstalled VersionOnline NeedUpdate Path

Pester PSGallery 4.4.0 4.4.2 True C:\Program Files\WindowsPowerShell\Modules\Pester

BEISPIEL 3

PS C:\> "Pester", "PSReadline" | Get-PackageUpdateInfo

Akzeptiert Modulnamen aus der Pipeline und gibt Update-Informationen für jedes angeforderte Modul zurück. Funktioniert auch mit Objekten, die eine Name-Eigenschaft besitzen, wie z.B. Module, die von Get-Module zurückgegeben werden.

BEISPIEL 4

PS C:\> Get-PackageUpdateInfo -CurrentUser -ShowOnlyNeededUpdate

Prüft nur Module, die im Profil des aktuellen Benutzers installiert sind, und zeigt nur jene Module an, für die online eine neuere Version verfügbar ist.

PARAMETER

-AllUsers

Beschränkt die Suche auf Module, die in gemeinsamen All-Users- oder System-Modulpfaden installiert sind.

Beachte, dass für das Aktualisieren dieser Module Administratorrechte erforderlich sind.

Type: SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: AllUsers
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-CurrentUser

Beschränkt die Suche auf Module, die im Profil des aktuellen Benutzers installiert sind.

Das ist hilfreich, wenn du ohne Administratorrechte arbeitest, was du als Standardarbeitsweise immer tun solltest.

Type: SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: CurrentUser
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Force

Umgeht das konfigurierte Update-Prüfintervall und führt sofort einen frischen Vergleich durch.

Type: SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Name

Ein oder mehrere Modulnamen, die geprüft werden sollen. Wenn dieser Parameter weggelassen wird, verwendet die Funktion die konfigurierten Einschlussregeln, um zu bestimmen, welche Module geprüft werden sollen.

Type: String[]
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: true
  ValueFromPipelineByPropertyName: true
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Repository

Ein oder mehrere PowerShell-Repositories, die nach verfügbaren Modulversionen abgefragt werden. Wenn weggelassen, verwendet der Befehl die auf dem lokalen System verfügbaren Repositories.

Type: String[]
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-ShowOnlyNeededUpdate

Unterdrückt Module, die bereits aktuell sind, in der Ausgabe und gibt nur Module zurück, für die ein Update verfügbar ist.

Type: SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-ShowToastNotification

Zeigt Windows-Toast-Benachrichtigungen für Module an, für die Updates verfügbar sind, wenn das System diese Funktion unterstützt.

Type: SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases:
- ToastNotification
- Notify
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

CommonParameters

EINGABEN

System.String[]

AUSGABEN

PackageUpdate.Info

HINWEISE

Version : 1.2.0.0 Autor : Andi Bellstedt Datum : 2026-06-21 Schlüsselwörter : PackageUpdateInfo, Update, Modul

4.4 - Get-PackageUpdateRule

SYNOPSIS

Ruft eine oder mehrere Paketaktualisierungsregeln ab, die zur Steuerung von Modulaktualisierungsprüfungen und -berichten verwendet werden.

SYNTAX

ShowAll (Standard)

Get-PackageUpdateRule [-IncludeModuleForChecking <string>] [-ExcludeModuleFromChecking <string>]
 [-IncludeDefaultRule] [-SettingObject <Configuration>] [<CommonParameters>]

ById

Get-PackageUpdateRule -Id <int[]> [-SettingObject <Configuration>] [<CommonParameters>]

ALIASES

Dieses Cmdlet hat folgende Aliase,

BESCHREIBUNG

Ruft die benutzerdefinierten Regeln ab, die definieren, wie Module während der Aktualisierungsprüfungen und -berichte behandelt werden. Sie können Regeln nach Bezeichner, nach Modulintegrations- oder Ausschlussmustern filtern oder die Standardregel aus dem aktiven Einstellungsobjekt einbeziehen, um das benutzerdefinierte Verhalten mit dem eingebauten Fallback-Verhalten zu vergleichen.

BEISPIELE

BEISPIEL 1

PS C:\> Get-PackageUpdateRule

Ruft alle aktuell konfigurierten benutzerdefinierten Regeln für die Paketaktualisierungsverwaltung ab.

BEISPIEL 2

PS C:\> Get-PackageUpdateRule -Id 1, 2

Ruft die benutzerdefinierten Regeln ab, die die angegebenen Bezeichner haben.

BEISPIEL 3

PS C:\> Get-PackageUpdateRule -ExcludeModuleFromChecking 'Pester'

Ruft die benutzerdefinierten Regeln ab, die Pester von der Aktualisierungsprüfung ausschließen.

BEISPIEL 4

PS C:\> Get-PackageUpdateRule -IncludeModuleForChecking 'PackageManagement' -IncludeDefaultRule

Ruft die benutzerdefinierten Regeln ab, die PackageManagement für die Aktualisierungsprüfung einschließen, und gibt außerdem die Standardregel zurück.

PARAMETER

-ExcludeModuleFromChecking

Filtert die zurückgegebenen Regeln auf diejenigen, die den angegebenen Modulnamen von der Aktualisierungsprüfung ausschließen.

Type: String
DefaultValue: ''
SupportsWildcards: false
Aliases:
- Exclude
- ExcludeModule
ParameterSets:
- Name: ShowAll
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Id

Gibt einen oder mehrere Regelbezeichner an, die abgerufen werden sollen.

Type: Int32[]
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: ById
  Position: Named
  IsRequired: true
  ValueFromPipeline: true
  ValueFromPipelineByPropertyName: true
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-IncludeDefaultRule

Fügt zusätzlich zu benutzerdefinierten Regeln die Standardregel aus dem angegebenen oder aktiven Einstellungsobjekt zur Ausgabe hinzu.

Type: SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: ShowAll
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-IncludeModuleForChecking

Filtert die zurückgegebenen Regeln auf diejenigen, die den angegebenen Modulnamen für die Aktualisierungsprüfung einschließen. Standardmäßig sind alle Module eingeschlossen, wenn kein Filter angegeben wird.

Standardwert ist: “*”

Type: String
DefaultValue: ''
SupportsWildcards: false
Aliases:
- Include
- IncludeModule
ParameterSets:
- Name: ShowAll
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-SettingObject

Gibt ein Einstellungsobjekt an, das von Get-PackageUpdateSetting zurückgegeben wird. Wenn dieser Parameter weggelassen wird, verwendet das Cmdlet das aktuelle Moduleinstellungsobjekt.

Type: Configuration
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: true
  ValueFromPipelineByPropertyName: true
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

CommonParameters

EINGABEN

System.Int32[]

PackageUpdate.Configuration

AUSGABEN

PackageUpdate.ModuleRule

HINWEISE

Version : 1.1.0.0 Autor : Andi Bellstedt Datum : 2026-06-21 Schlüsselwörter : PackageUpdateInfo, Update, Module, Rule

4.5 - Get-PackageUpdateSetting

SYNOPSIS

Liest die PackageUpdateInfo-Konfiguration aus der Modul-Einstellungsdatei aus.

SYNTAX

__AllParameterSets

Get-PackageUpdateSetting [[-Path] <string>] [<CommonParameters>]

ALIASES

Dieses Cmdlet hat folgende Aliase,

BESCHREIBUNG

Liest die PackageUpdateInfo-Konfigurationsdatei und gibt die aktuellen Moduleinstellungen als PackageUpdate.Configuration-Objekt zurück. Das zurückgegebene Objekt enthält die Standard- und benutzerdefinierten Aktualisierungsregeln, das Intervall für Updateprüfungen sowie die Zeitstempel der letzten und der letzten erfolgreichen Prüfung.

BEISPIELE

BEISPIEL 1

PS C:\> Get-PackageUpdateSetting

Liest die aktuellen PackageUpdateInfo-Einstellungen aus der Standard-Konfigurationsdatei aus.

BEISPIEL 2

PS C:\> Get-PackageUpdateSetting -Path "C:\temp\PackageUpdateInfo.json"

Liest die PackageUpdateInfo-Konfiguration aus einer bestimmten Einstellungsdatei.

BEISPIEL 3

PS C:\> Get-PackageUpdateSetting | Select-Object -ExpandProperty UpdateCheckInterval

Gibt das konfigurierte Intervall für Updateprüfungen aus den aktuellen Einstellungen zurück.

PARAMETER

-Path

Der vollständige Pfad zur auszulesenden Einstellungsdatei.

Dieser Parameter ist optional. Wird er weggelassen, verwendet die Funktion den Standardpfad der Moduleinstellungen: Linux: “$HOME/.config/powershell/PackageUpdateInfo/PackageUpdateInfo_$($PSEdition)$($PSVersionTable.PSVersion.Major).json” Windows: “$HOME\AppData\Local\Microsoft\Windows\PowerShell\PackageUpdateInfo$($PSEdition)_$($PSVersionTable.PSVersion.Major).json”

Type: String
DefaultValue: $script:ModuleSettingPath
SupportsWildcards: false
Aliases:
- FullName
- FilePath
ParameterSets:
- Name: (All)
  Position: 0
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

CommonParameters

AUSGABEN

PackageUpdate.Configuration

HINWEISE

Version : 1.1.0.0 Autor : Andi Bellstedt Datum : 2026-06-21 Schlüsselwörter : PackageUpdateInfo, Update, Modul, Einstellung

4.6 - Import-PackageUpdateInfo

SYNOPSIS

Importiert Paket-Update-Informationen aus einer zuvor exportierten Datendatei.

SYNTAX

__AllParameterSets

Import-PackageUpdateInfo [[-Path] <string>] [-ShowToastNotification] [-InputFormat <string>]
 [-Encoding <string>] [-WhatIf] [-Confirm] [<CommonParameters>]

ALIASES

Dieses Cmdlet hat die folgenden Aliase,

BESCHREIBUNG

Importiert Paket-Update-Informationen aus einer Datendatei, die zuvor mit Export-PackageUpdateInfo exportiert wurde. Der Befehl liest Datensätze aus XML-, JSON- oder CSV-Dateien und wandelt sie in PackageUpdateInfo-Objekte zur weiteren Verwendung, Anzeige oder Verarbeitung um. Auf Wunsch kann er auch Windows-Toast-Benachrichtigungen für Module anzeigen, die ein Update benötigen.

BEISPIELE

BEISPIEL 1

PS C:\> Import-PackageUpdateInfo

Importiert die Standard-Paket-Update-Informationsdatei für die aktuelle PowerShell-Umgebung.

BEISPIEL 2

PS C:\> Import-PackageUpdateInfo -Path C:\temp\packageupdateinfo.xml

Importiert Update-Informationen aus einer bestimmten XML-Datei.

BEISPIEL 3

PS C:\> Import-PackageUpdateInfo -Path .\updates.json -InputFormat JSON

Importiert Update-Informationen aus einer JSON-Datei, die das angegebene Eingabeformat verwendet.

BEISPIEL 4

PS C:\> Import-PackageUpdateInfo -Path .\updates.csv -InputFormat CSV -ShowToastNotification

Importiert Update-Informationen aus einer CSV-Datei und zeigt Toast-Benachrichtigungen für Module an, die Updates benötigen.

PARAMETER

-Confirm

Wenn dieser Schalter aktiviert ist, wirst du vor der Ausführung von Operationen, die den Zustand ändern, zur Bestätigung aufgefordert.

Type: SwitchParameter
DefaultValue: ''
SupportsWildcards: false
Aliases:
- cf
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Encoding

Gibt die beim Lesen der Eingabedatei verwendete Dateicodierung an.

Type: String
DefaultValue: default
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-InputFormat

Gibt das Format der importierten Datendatei an. Unterstützte Werte sind “XML”, “JSON” und “CSV”.

Type: String
DefaultValue: XML
SupportsWildcards: false
Aliases:
- Format
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Path

Der Dateipfad zur zu importierenden Datendatei. Gib einen gültigen Dateipfad an. Wenn ausgelassen, verwendet der Befehl die Standard-Modul-Datendatei für die aktuelle PowerShell-Edition und -Version.

Standardpfade sind: Linux: “$HOME/.config/powershell/PackageUpdateInfo/PackageUpdateInfo_$($PSEdition)$($PSVersionTable.PSVersion.Major).xml” Windows: “$HOME\AppData\Local\Microsoft\Windows\PowerShell\PackageUpdateInfo$($PSEdition)_$($PSVersionTable.PSVersion.Major).xml”

Type: String
DefaultValue: ''
SupportsWildcards: false
Aliases:
- FullName
- FilePath
ParameterSets:
- Name: (All)
  Position: 0
  IsRequired: false
  ValueFromPipeline: true
  ValueFromPipelineByPropertyName: true
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-ShowToastNotification

Zeigt Windows-Toast-Benachrichtigungen mit Release-Notes für Module an, die ein Update benötigen.

Type: SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases:
- ToastNotification
- Notify
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-WhatIf

Wenn dieser Schalter aktiviert ist, werden keine Aktionen ausgeführt, aber Informationsmeldungen angezeigt, die erklären, was passieren würde, wenn der Befehl ausgeführt würde.

Type: SwitchParameter
DefaultValue: ''
SupportsWildcards: false
Aliases:
- wi
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

CommonParameters

EINGABEN

System.String

AUSGABEN

PackageUpdateInfo

HINWEISE

Version : 1.1.0.0 Autor : Andi Bellstedt Datum : 2026-06-21 Schlüsselwörter : PackageUpdateInfo, Update, Modul, Info

4.7 - Remove-PackageUpdateRule

SYNOPSIS

Entfernt eine oder mehrere benutzerdefinierte Update-Verarbeitungsregeln aus der Paket-Update-Konfiguration.

SYNTAX

ById (Standard)

Remove-PackageUpdateRule -Id <int[]> [-Force] [-PassThru] [-SettingObject <Configuration>] [-WhatIf]
 [-Confirm] [<CommonParameters>]

ByInputObject

Remove-PackageUpdateRule -InputObject <ModuleRule[]> [-Force] [-PassThru]
 [-SettingObject <Configuration>] [-WhatIf] [-Confirm] [<CommonParameters>]

ALIASES

Dieses Cmdlet hat folgende Aliase,

BESCHREIBUNG

Entfernt vorhandene benutzerdefinierte Regeln, die definieren, wie bestimmte PowerShell-Module während Update-Prüfungen und Berichten behandelt werden sollen. Der Befehl kann Regeln anhand der Regel-Id entfernen, indem Regelobjekte von Get-PackageUpdateRule übergeben werden, oder indem ein Einstellungsobjekt aktualisiert wird, das die Regelkollektion enthält.

Wenn Regeln entfernt werden, wird die aktualisierte Konfiguration zurück in die Einstellungsdatei geschrieben, sodass die Änderung erhalten bleibt. Verwende -PassThru, um die entfernten Regelobjekte an die Pipeline zurückzugeben.

BEISPIELE

BEISPIEL 1

PS C:\> Get-PackageUpdateRule | Remove-PackageUpdateRule

Entfernt alle benutzerdefinierten Update-Regeln aus den aktuellen Moduleinstellungen.

BEISPIEL 2

PS C:\> Remove-PackageUpdateRule -Id 12

Entfernt die benutzerdefinierte Regel mit der Id 12 aus der aktuellen Konfiguration.

BEISPIEL 3

$rules = Get-PackageUpdateRule -Name "Microsoft.PowerShell.Utility"
PS C:\> $rules | Remove-PackageUpdateRule -PassThru

Entfernt die passenden Regeln und gibt die entfernten Regelobjekte an die Pipeline zurück.

BEISPIEL 4

$settings = Get-PackageUpdateSetting
PS C:\> Remove-PackageUpdateRule -Id 3 -SettingObject $settings -Force

Entfernt eine bestimmte Regel ohne Nachfrage und schreibt die aktualisierten Einstellungen zurück auf die Festplatte.

PARAMETER

-Confirm

Wenn dieser Schalter aktiviert ist, wirst du vor der Ausführung von Operationen, die den Zustand ändern, zur Bestätigung aufgefordert.

Type: SwitchParameter
DefaultValue: ''
SupportsWildcards: false
Aliases:
- cf
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Force

Unterdrückt die Bestätigungsabfrage und entfernt die Regel sofort.

Type: SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Id

Die Id der zu entfernenden Regel. Akzeptiert eine oder mehrere Regel-IDs.

Type: Int32[]
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: ById
  Position: Named
  IsRequired: true
  ValueFromPipeline: true
  ValueFromPipelineByPropertyName: true
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-InputObject

Ein oder mehrere Regelobjekte, die entfernt werden sollen. Diese werden typischerweise von Get-PackageUpdateRule zurückgegeben.

Type: ModuleRule[]
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: ByInputObject
  Position: Named
  IsRequired: true
  ValueFromPipeline: true
  ValueFromPipelineByPropertyName: true
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-PassThru

Gibt die entfernten Regelobjekte zur weiteren Verarbeitung an die Pipeline zurück.

Type: SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-SettingObject

Das Konfigurationsobjekt, das die Regelkollektion enthält. Wenn dieser Parameter nicht angegeben wird, verwendet der Befehl die aktuellen Moduleinstellungen von Get-PackageUpdateSetting.

Type: Configuration
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: true
  ValueFromPipelineByPropertyName: true
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-WhatIf

Wenn dieser Schalter aktiviert ist, werden keine Aktionen ausgeführt, aber Informationsmeldungen angezeigt, die erklären, was passieren würde, wenn der Befehl ausgeführt würde.

Type: SwitchParameter
DefaultValue: ''
SupportsWildcards: false
Aliases:
- wi
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

CommonParameters

EINGABEN

System.Int32[]

PackageUpdate.ModuleRule[]

PackageUpdate.Configuration

AUSGABEN

PackageUpdate.ModuleRule

HINWEISE

Version : 1.1.0.0 Autor : Andi Bellstedt Datum : 2026-06-21 Schlüsselwörter : PackageUpdateInfo, Update, Modul, Regel

4.8 - Set-PackageUpdateRule

SYNOPSIS

Aktualisiert eine bestehende PackageUpdateInfo-Regel, die steuert, wie Modulversionsänderungen gemeldet werden.

SYNTAX

ById (Standard)

Set-PackageUpdateRule -Id <int> [-IncludeModuleForChecking <string[]>]
 [-ExcludeModuleFromChecking <string[]>] [-ReportChangeOnMajor <bool>] [-ReportChangeOnMinor <bool>]
 [-ReportChangeOnBuild <bool>] [-ReportChangeOnRevision <bool>] [-SettingObject <Configuration>]
 [-PassThru] [-WhatIf] [-Confirm] [<CommonParameters>]

ByInputObject

Set-PackageUpdateRule -InputObject <ModuleRule[]> [-IncludeModuleForChecking <string[]>]
 [-ExcludeModuleFromChecking <string[]>] [-ReportChangeOnMajor <bool>] [-ReportChangeOnMinor <bool>]
 [-ReportChangeOnBuild <bool>] [-ReportChangeOnRevision <bool>] [-SettingObject <Configuration>]
 [-PassThru] [-WhatIf] [-Confirm] [<CommonParameters>]

ALIASES

Dieses Cmdlet hat folgende Aliase,

BESCHREIBUNG

Dieses Cmdlet ändert eine bestehende Aktualisierungsregel, die in der PackageUpdateInfo-Konfiguration gespeichert ist, sodass Aktualisierungsprüfungen für bestimmte Module eingeschränkt oder erweitert werden können.
Du kannst es verwenden, um Module von der Aktualisierungserkennung auszuschließen oder einzubeziehen, steuern, welche Versionsbestandteile eine Aktualisierungsbenachrichtigung auslösen, und diese Regeländerungen in der aktiven Einstellungsdatei speichern.
Der Befehl arbeitet mit einer Regel, die durch Id identifiziert wird, oder mit einem Regelobjekt, das über InputObject übergeben wird, und kann die aktualisierte Regel zurückgeben, wenn -PassThru angegeben ist.

BEISPIELE

BEISPIEL 1

PS C:\> Set-PackageUpdateRule -Id 3 -IncludeModuleForChecking 'MyModule' -ReportChangeOnMajor $true -ReportChangeOnMinor $true -ReportChangeOnBuild $true -ReportChangeOnRevision $false -PassThru

Aktualisiert Regel 3 so, dass MyModule explizit ausgewertet wird und nur Änderungen an Major-, Minor- und Build-Versionen als Aktualisierungsbedarf gemeldet werden.

BEISPIEL 2

PS C:\> Get-PackageUpdateRule -Id 7 | Set-PackageUpdateRule -ExcludeModuleFromChecking 'AzureTools' -ReportChangeOnRevision $false

Nimmt die Regel mit Id 7 aus der Pipeline und unterdrückt die Aktualisierungsbenachrichtigung basierend auf Revisionen für AzureTools, während die Regel in den aktuellen Einstellungen gespeichert bleibt.

BEISPIEL 3

$rule = Get-PackageUpdateRule -Id 12
PS C:\> Set-PackageUpdateRule -InputObject $rule -IncludeModuleForChecking 'PowershellGet','PSReadLine' -ReportChangeOnMinor $false -ReportChangeOnBuild $false

Lädt ein bestehendes Regelobjekt, erweitert die eingeschlossenen Module und aktualisiert die Regel so, dass nur Major- und Revisionsänderungen als relevante Updates behandelt werden.

BEISPIEL 4

PS C:\> Set-PackageUpdateRule -Id 5 -ReportChangeOnMajor $false -ReportChangeOnMinor $false -ReportChangeOnBuild $false -ReportChangeOnRevision $true -WhatIf

Zeigt die Auswirkung der Änderung von Regel 5, sodass nur revisionsbasierte Updates gemeldet werden, ohne die Änderung tatsächlich zu speichern.

PARAMETER

-Confirm

Fordert eine Bestätigung an, bevor das Cmdlet die geänderten Regel-Daten zurück in die Einstellungsdatei schreibt.

Type: SwitchParameter
DefaultValue: ''
SupportsWildcards: false
Aliases:
- cf
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-ExcludeModuleFromChecking

Ein oder mehrere Modulnamen, die von den Aktualisierungsprüfungen für die zu ändernde Regel ausgeschlossen werden sollen.

Type: String[]
DefaultValue: ''
SupportsWildcards: false
Aliases:
- Exclude
- ExcludeModule
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Id

Die numerische Kennung der zu ändernden Regel.

Type: Int32
DefaultValue: 0
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: ById
  Position: Named
  IsRequired: true
  ValueFromPipeline: true
  ValueFromPipelineByPropertyName: true
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-IncludeModuleForChecking

Ein oder mehrere Modulnamen, die in die Aktualisierungsprüfungen für die zu ändernde Regel einbezogen werden sollen.
Wenn ausgelassen, behält die Regel das Standardverhalten bei, alle Module auszuwerten.

Type: String[]
DefaultValue: ''
SupportsWildcards: false
Aliases:
- Include
- IncludeModule
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-InputObject

Das zu aktualisierende Regelobjekt.
Dies ist nützlich, wenn du bereits eine Regel von Get-PackageUpdateRule hast und sie ändern möchtest, ohne ihre Id anzugeben.

Type: ModuleRule[]
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: ByInputObject
  Position: Named
  IsRequired: true
  ValueFromPipeline: true
  ValueFromPipelineByPropertyName: true
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-PassThru

Gibt das aktualisierte Regelobjekt an die Pipeline zurück, nachdem die Änderung in der Einstellungsdatei gespeichert wurde.

Type: SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-ReportChangeOnBuild

Steuert, ob eine Änderung im Build-Versionsbestandteil dazu führt, dass die Regel meldet, dass ein Update benötigt wird.

Meldet, wenn sich die Build-Version eines Moduls ändert

Das bedeutet, ‘Get-PackageUpdateSetting’ meldet einen Aktualisierungsbedarf,
nur wenn sich die Build-Version eines Moduls ändert.

Major Minor Build Revision

0 0 1 0

Type: Boolean
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-ReportChangeOnMajor

Steuert, ob eine Änderung im Major-Versionsbestandteil dazu führt, dass die Regel meldet, dass ein Update benötigt wird.

Meldet, wenn sich die Major-Version eines Moduls ändert

Das bedeutet, ‘Get-PackageUpdateSetting’ meldet einen Aktualisierungsbedarf,
nur wenn sich die Major-Version eines Moduls ändert.

Major Minor Build Revision

1 0 0 0

Type: Boolean
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-ReportChangeOnMinor

Steuert, ob eine Änderung im Minor-Versionsbestandteil dazu führt, dass die Regel meldet, dass ein Update benötigt wird.

Meldet, wenn sich die Minor-Version eines Moduls ändert

Das bedeutet, ‘Get-PackageUpdateSetting’ meldet einen Aktualisierungsbedarf,
nur wenn sich die Minor-Version eines Moduls ändert.

Major Minor Build Revision

0 1 0 0

Type: Boolean
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-ReportChangeOnRevision

Steuert, ob eine Änderung im Revisions-Versionsbestandteil dazu führt, dass die Regel meldet, dass ein Update benötigt wird.

Meldet, wenn sich der Revisionsbestandteil eines Moduls ändert

Das bedeutet, ‘Get-PackageUpdateSetting’ meldet einen Aktualisierungsbedarf,
nur wenn sich die Revisionsversion eines Moduls ändert.

Major Minor Build Revision

0 0 0 1

Type: Boolean
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-SettingObject

Das PackageUpdateInfo-Konfigurationsobjekt, das aktualisiert werden soll.
Wenn ausgelassen, verwendet das Cmdlet die aktuellen Moduleinstellungen von Get-PackageUpdateSetting.

Type: Configuration
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: true
  ValueFromPipelineByPropertyName: true
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-WhatIf

Zeigt an, was passieren würde, wenn der Befehl ausgeführt wird, ohne Änderungen anzuwenden.

Type: SwitchParameter
DefaultValue: ''
SupportsWildcards: false
Aliases:
- wi
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter: -Debug, -ErrorAction, -ErrorVariable,
-InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable,
-ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter
about_CommonParameters.

EINGABEN

System.Int32

PackageUpdate.ModuleRule[]

PackageUpdate.Configuration

AUSGABEN

PackageUpdate.ModuleRule

HINWEISE

Version : 1.1.0.0
Autor : Andi Bellstedt
Datum : 2026-06-21
Schlüsselwörter : PackageUpdateInfo, Update, Module, Rule

4.9 - Set-PackageUpdateSetting

SYNOPSIS

Konfiguriert das Verhalten der Update-Prüfung und die Berichtsoptionen für PackageUpdateInfo.

SYNTAX

SetBehaviour

Set-PackageUpdateSetting [-ExcludeModuleFromChecking <string[]>]
 [-IncludeModuleForChecking <string[]>] [-ReportChangeOnMajor <bool>] [-ReportChangeOnMinor <bool>]
 [-ReportChangeOnBuild <bool>] [-ReportChangeOnRevision <bool>] [-UpdateCheckInterval <timespan>]
 [-LastCheck <datetime>] [-LastSuccessfulCheck <datetime>] [-InputObject <Configuration>]
 [-Path <string>] [-PassThru] [-WhatIf] [-Confirm] [<CommonParameters>]

ResetBehaviour

Set-PackageUpdateSetting [-Reset] [-Path <string>] [-PassThru] [-WhatIf] [-Confirm]
 [<CommonParameters>]

ALIASES

Dieses Cmdlet hat die folgenden Aliase,

BESCHREIBUNG

Konfiguriert, wie PackageUpdateInfo installierte PowerShell-Module auf verfügbare Updates überprüft.
Verwende diesen Befehl, um zu steuern, welche Module in die Update-Prüfung einbezogen oder davon ausgeschlossen werden,
festzulegen, welche Versionsänderungen Update-Benachrichtigungen auslösen sollen, zu definieren, wie oft Update-Prüfungen durchgeführt werden,
und um die gespeicherten Einstellungen auf die Standardwerte zurückzusetzen.
Die Konfiguration wird in einer JSON-Einstellungsdatei gespeichert und kann entweder direkt angewendet oder durch Übergabe eines bestehenden Konfigurationsobjekts genutzt werden.

BEISPIELE

BEISPIEL 1

PS C:\> Set-PackageUpdateSetting -ExcludeModuleFromChecking "MyLocalOnlyModule"

Setzt das Modul “MyLocalOnlyModule” auf die Ausschlussliste für Update-Prüfungen.
Dies sollte nur für Module gelten, die nicht in einer Online-Galerie verfügbar sind.
Diese Funktion soll unnötige Update-Prüfungen für Module vermeiden, die nicht in einer Online-Galerie existieren.

Du erhältst keine Update-Informationen für das Modul ‘MyLocalOnlyModule’ mehr!

Wenn du wegen einer großen Anzahl installierter Module Bedenken hinsichtlich der Performance hast, solltest du besser die Praxis verfolgen, den ‘Prüfmechanismus’ als Job-Routine in deinem PSProfile bei jedem Shell-Start auszuführen.
Wie das geht, wird in der ‘praktischen Nutzung’ auf der GitHub-Projektseite beschrieben:
https://github.com/AndiBellstedt/PackageUpdateInfo#practical-usage

BEISPIEL 2

PS C:\> Set-PackageUpdateSetting -ExcludeModuleFromChecking "Az.*"

Setzt alle Az.-Module auf die Ausschlussliste für Update-Prüfungen.
Dies sollte als schlechte Praxis angesehen werden, da du keine Update-Informationen mehr für alle Az.-Module erhältst.
(Und diese ändern sich recht häufig.)

BEISPIEL 3

PS C:\> Set-PackageUpdateSetting -IncludeModuleForChecking "*" -ReportChangeOnMajor $true -ReportChangeOnMinor $true -ReportChangeOnBuild $true -ReportChangeOnRevision $true -UpdateCheckInterval "01:00:00"

Stellt das Standardverhalten der Update-Prüfung und die Benachrichtigungsschwellen wieder her, während das konfigurierte Update-Intervall auf eine Stunde gesetzt bleibt.

BEISPIEL 4

PS C:\> Set-PackageUpdateSetting -Reset

Setzt die Paket-Update-Einstellungen auf die eingebauten Standardwerte zurück.

BEISPIEL 5

PS C:\> Get-PackageUpdateSetting | Set-PackageUpdateSetting -PassThru

Aktualisiert das aktuelle Konfigurationsobjekt im Speicher und gibt es zur weiteren Verarbeitung an die Pipeline zurück.

PARAMETER

-Confirm

Fordert vor der Ausführung einer zustandsändernden Operation eine Bestätigung an.

Type: SwitchParameter
DefaultValue: ''
SupportsWildcards: false
Aliases:
- cf
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-ExcludeModuleFromChecking

Die Namen der Module, die in der Standardregel von der Update-Prüfung ausgeschlossen werden sollen.

Type: String[]
DefaultValue: ''
SupportsWildcards: false
Aliases:
- Exclude
- ExcludeModule
ParameterSets:
- Name: SetBehaviour
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-IncludeModuleForChecking

Die Namen der Module, die in der Standardregel in die Update-Prüfung eingeschlossen werden sollen.
Standardmäßig sind alle Module eingeschlossen.

Standardwert ist: “*”

Type: String[]
DefaultValue: ''
SupportsWildcards: false
Aliases:
- Include
- IncludeModule
ParameterSets:
- Name: SetBehaviour
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-InputObject

Ein von Get-PackageUpdateSetting zurückgegebenes Konfigurationsobjekt, das vor Ort aktualisiert werden soll.

Type: Configuration
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: SetBehaviour
  Position: Named
  IsRequired: false
  ValueFromPipeline: true
  ValueFromPipelineByPropertyName: true
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-LastCheck

Der Zeitstempel, wann der letzte Update-Prüfzyklus für Module gestartet wurde.

Type: DateTime
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: SetBehaviour
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-LastSuccessfulCheck

Der Zeitstempel, wann der letzte Update-Prüfzyklus erfolgreich abgeschlossen wurde.

Type: DateTime
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: SetBehaviour
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-PassThru

Gibt das aktualisierte Einstellungsobjekt zur weiteren Verarbeitung an die Pipeline zurück.

Type: SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Path

Der vollständige Pfad zur Einstellungsdatei, die gelesen oder beschrieben werden soll.

Wenn dieser Parameter weggelassen wird, verwendet der Befehl den Standard-Einstellungs-Pfad des Moduls:
Linux: “$HOME/.config/powershell/PackageUpdateInfo/PackageUpdateSetting_$($PSEdition)$($PSVersionTable.PSVersion.Major).json”
Windows: “$HOME\AppData\Local\Microsoft\Windows\PowerShell\PackageUpdateSetting$($PSEdition)_$($PSVersionTable.PSVersion.Major).json”

Type: String
DefaultValue: ''
SupportsWildcards: false
Aliases:
- FullName
- FilePath
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-ReportChangeOnBuild

Gibt an, ob eine Änderung der Build-Version eines Moduls in der Standardregel eine Update-Benachrichtigung auslösen soll.

Das bedeutet, Get-PackageUpdateSetting meldet einen Update-Bedarf nur, wenn sich die Build-Versionsnummer eines Moduls ändert.

Major Minor Build Revision

0 0 1 0

Type: Boolean
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: SetBehaviour
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-ReportChangeOnMajor

Gibt an, ob eine Änderung der Hauptversion eines Moduls in der Standardregel eine Update-Benachrichtigung auslösen soll.

Das bedeutet, Get-PackageUpdateSetting meldet einen Update-Bedarf nur, wenn sich die Hauptversionsnummer eines Moduls ändert.

Major Minor Build Revision

1 0 0 0

Type: Boolean
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: SetBehaviour
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-ReportChangeOnMinor

Gibt an, ob eine Änderung der Nebenversion eines Moduls in der Standardregel eine Update-Benachrichtigung auslösen soll.

Das bedeutet, Get-PackageUpdateSetting meldet einen Update-Bedarf nur, wenn sich die Nebenversion eines Moduls ändert.

Major Minor Build Revision

0 1 0 0

Type: Boolean
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: SetBehaviour
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-ReportChangeOnRevision

Gibt an, ob eine Änderung im Revisionsanteil der Modulversion in der Standardregel eine Update-Benachrichtigung auslösen soll.

Das bedeutet, Get-PackageUpdateSetting meldet einen Update-Bedarf nur, wenn sich die Revisionsnummer eines Moduls ändert.

Major Minor Build Revision

1 0 0 0

Type: Boolean
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: SetBehaviour
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Reset

Setzt die Modulkontrolle auf das Standardverhalten zurück.

Type: SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: ResetBehaviour
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-UpdateCheckInterval

Der minimale Zeitraum, der vergehen muss, bevor eine neue Modul-Update-Prüfung durchgeführt wird.

Standardwert ist: “01:00:00”

Type: TimeSpan
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: SetBehaviour
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-WhatIf

Zeigt an, was passieren würde, wenn der Befehl ausgeführt wird, ohne tatsächlich Änderungen vorzunehmen.

Type: SwitchParameter
DefaultValue: ''
SupportsWildcards: false
Aliases:
- wi
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter: -Debug, -ErrorAction, -ErrorVariable,
-InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable,
-ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter
about_CommonParameters.

EINGABEN

PackageUpdate.Configuration

AUSGABEN

PackageUpdate.Configuration

HINWEISE

Version : 1.1.0.0
Autor : Andi Bellstedt
Datum : 2026-06-21
Schlüsselwörter : PackageUpdateInfo, Update, Modul, Einstellung

4.10 - Show-PackageUpdateReleaseNote

SYNOPSIS

Zeigt Versionshinweise für ein oder mehrere PowerShell-Module an.

SYNTAX

ByPackageUpdateInfoObject

Show-PackageUpdateReleaseNote [[-InputObject] <Info[]>] [-WhatIf] [-Confirm] [<CommonParameters>]

ByModuleObject

Show-PackageUpdateReleaseNote [[-Module] <psmoduleinfo[]>] [-WhatIf] [-Confirm] [<CommonParameters>]

ALIASES

Dieses Cmdlet hat folgende Aliase,

BESCHREIBUNG

Ruft Versionshinweise für Modul-Informationsobjekte ab, die von Get-PackageUpdateInfo oder Import-PackageUpdateInfo erzeugt wurden, oder für Modulobjekte, die von Get-Module zurückgegeben werden.
Wenn Versionshinweise als URL verfügbar sind, versucht das Cmdlet, den Inhalt aufzulösen und abzurufen, damit die Hinweise direkt dem Aufrufer präsentiert werden können.

BEISPIELE

BEISPIEL 1

PS C:\> Get-PackageUpdateInfo | Show-PackageUpdateReleaseNote

Ruft Versionshinweise für jedes Modul ab, das von Get-PackageUpdateInfo zurückgegeben wird.

BEISPIEL 2

PS C:\> Get-Module PackageUpdateInfo | Show-PackageUpdateReleaseNote

Ruft Versionshinweise für das PackageUpdateInfo-Modul aus der aktuellen PowerShell-Sitzung ab.

BEISPIEL 3

PS C:\> Get-PackageUpdateInfo -Name PackageUpdateInfo | Show-PackageUpdateReleaseNote

Zeigt die Versionshinweise für ein bestimmtes Modul anhand der Ausgabe von Get-PackageUpdateInfo an.

BEISPIEL 4

PS C:\> Get-PackageUpdateInfo | Show-PackageUpdateReleaseNote -WhatIf

Zeigt an, welche Module für die Versionshinweisabfrage verarbeitet würden, ohne die Operation tatsächlich auszuführen.

PARAMETER

-Confirm

Wenn dieser Schalter aktiviert ist, wirst du vor der Ausführung von Operationen, die den Zustand ändern, um eine Bestätigung gebeten.

Type: SwitchParameter
DefaultValue: ''
SupportsWildcards: false
Aliases:
- cf
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-InputObject

Ein oder mehrere PackageUpdateInfo-Objekte von Get-PackageUpdateInfo oder Import-PackageUpdateInfo, die Versionshinweis-Informationen enthalten.

Type: Info[]
DefaultValue: ''
SupportsWildcards: false
Aliases:
- Input
ParameterSets:
- Name: ByPackageUpdateInfoObject
  Position: 0
  IsRequired: false
  ValueFromPipeline: true
  ValueFromPipelineByPropertyName: true
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Module

Ein oder mehrere Modulobjekte von Get-Module, die Metadaten zu Versionshinweisen oder eine URL zu Versionshinweisen enthalten.

Type: PSModuleInfo[]
DefaultValue: ''
SupportsWildcards: false
Aliases:
- ModuleName
ParameterSets:
- Name: ByModuleObject
  Position: 0
  IsRequired: false
  ValueFromPipeline: true
  ValueFromPipelineByPropertyName: true
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-WhatIf

Wenn dieser Schalter aktiviert ist, werden keine Aktionen ausgeführt, aber Informationsmeldungen angezeigt, die erklären, was passieren würde, wenn der Befehl ausgeführt würde.

Type: SwitchParameter
DefaultValue: ''
SupportsWildcards: false
Aliases:
- wi
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter: -Debug, -ErrorAction, -ErrorVariable,
-InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable,
-ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter
about_CommonParameters.

EINGABEN

PackageUpdate.Info[]

System.Management.Automation.PSModuleInfo[]

AUSGABEN

PackageUpdate.ReleaseNote

HINWEISE

Version : 1.1.0.0
Autor : Andi Bellstedt
Datum : 2026-06-21
Schlüsselwörter : PackageUpdateInfo, Update, Modul, Versionshinweis

Über diese Dokumentation

Über das Modul

Ressourcen

Mitwirken

1 - Übersicht

Was macht PackageUpdateInfo?

Warum PackageUpdateInfo verwenden?

Komfort

Automatisierung

Flexibilität

Voraussetzungen

Installation

Schneller Einstieg

Praktisches Automatisierungsmuster

Nächste Schritte

2 - Betriebsempfehlungen

Beginne mit dem Standardverhalten

Nutze Update-Intervalle, um Rauschen zu reduzieren

Bevorzuge nicht-blockierende Shell-Starts

Überprüfungen explizit bei Bedarf einschränken

Regeln sorgfältig entwerfen

Exportieren/Importieren gezielt einsetzen

Benachrichtigungen sinnvoll nutzen

3 - Fehlerbehebung

Erste Schritte: Aktionsfähige Diagnosen

Wird übersprungen unerwartet?

Konfigurationsdatei fehlt oder ist beschädigt

Keine Module werden zurückgegeben

Export schlägt wegen Pfadfehlern fehl

Import liefert keine Daten

Toast-Benachrichtigungen erscheinen nicht

Regeln können nicht hinzugefügt oder geändert werden

Repository- und Netzwerkprobleme

Wiederherstellungsablauf

4 - Modulbefehle Referenz

4.1 - Add-PackageUpdateRule

SYNOPSIS

SYNTAX

__AllParameterSets

ALIASES

BESCHREIBUNG

BEISPIELE

BEISPIEL 1

BEISPIEL 2

BEISPIEL 3

BEISPIEL 4

PARAMETER

-Confirm

-ExcludeModuleFromChecking

-Id

-IncludeModuleForChecking

-PassThru

-ReportChangeOnBuild

-ReportChangeOnMajor

-ReportChangeOnMinor

-ReportChangeOnRevision

-SettingObject

-WhatIf

CommonParameters

EINGABEN

PackageUpdate.Configuration

AUSGABEN

PackageUpdate.ModuleRule

HINWEISE

VERWANDTE LINKS

4.2 - Export-PackageUpdateInfo

SYNOPSIS

SYNTAX

__AllParameterSets

ALIASES

BESCHREIBUNG

BEISPIELE

BEISPIEL 1

BEISPIEL 2

BEISPIEL 3

BEISPIEL 4

PARAMETER

-Append

-Confirm

-Encoding