# Set-PackageUpdateSetting LLMS index: [llms.txt](/llms.txt) --- ## SYNOPSIS Konfiguriert das Verhalten der Update-Prüfung und die Berichtsoptionen für PackageUpdateInfo. ## SYNTAX ### SetBehaviour ``` Set-PackageUpdateSetting [-ExcludeModuleFromChecking ] [-IncludeModuleForChecking ] [-ReportChangeOnMajor ] [-ReportChangeOnMinor ] [-ReportChangeOnBuild ] [-ReportChangeOnRevision ] [-UpdateCheckInterval ] [-LastCheck ] [-LastSuccessfulCheck ] [-InputObject ] [-Path ] [-PassThru] [-WhatIf] [-Confirm] [] ``` ### ResetBehaviour ``` Set-PackageUpdateSetting [-Reset] [-Path ] [-PassThru] [-WhatIf] [-Confirm] [] ``` ## 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 ```powershell 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 ```powershell 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.) 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 3 ```powershell 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 ```powershell PS C:\> Set-PackageUpdateSetting -Reset ``` Setzt die Paket-Update-Einstellungen auf die eingebauten Standardwerte zurück. ### BEISPIEL 5 ```powershell 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. ```yaml 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. ```yaml 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: "*" ```yaml 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. ```yaml 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. ```yaml 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. ```yaml 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. ```yaml 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" ```yaml 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 ```yaml 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 ```yaml 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 ```yaml 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 ```yaml 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. ```yaml 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" ```yaml 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. ```yaml 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](https://go.microsoft.com/fwlink/?LinkID=113216). ## 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 ## VERWANDTE LINKS - [packageupdateinfo.andibellstedt.com/docs/commands/set-packageupdatesetting](https://packageupdateinfo.andibellstedt.com/docs/commands/set-packageupdatesetting/)