Set-PackageUpdateSetting

For AI agents: a documentation index is available at /llms.txt; a markdown version of this page is available at /de/docs/commands/set-packageupdatesetting/index.md.

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.)

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

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

VERWANDTE LINKS

• packageupdateinfo.andibellstedt.com/docs/commands/set-packageupdatesetting