# Add-PackageUpdateRule LLMS index: [llms.txt](/llms.txt) --- ## SYNOPSIS Fügt eine benutzerdefinierte Regel hinzu, die steuert, wie Modul-Updates gemeldet werden. ## SYNTAX ### __AllParameterSets ``` Add-PackageUpdateRule [[-Id] ] [[-IncludeModuleForChecking] ] [[-ExcludeModuleFromChecking] ] [[-ReportChangeOnMajor] ] [[-ReportChangeOnMinor] ] [[-ReportChangeOnBuild] ] [[-ReportChangeOnRevision] ] [[-SettingObject] ] [-PassThru] [-WhatIf] [-Confirm] [] ``` ## 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 ```powershell 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 ```powershell 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 ```powershell 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 ```powershell 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. ```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 Ein oder mehrere Modulnamen, die von der Update-Prüfung durch diese Regel ausgeschlossen werden sollen. ```yaml 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. ```yaml 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. ```yaml 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. ```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: '' ``` ### -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 ```yaml 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 ```yaml 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 ```yaml 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 ```yaml 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. ```yaml 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. ```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.ModuleRule ## HINWEISE Version : 1.1.0.0 Autor : Andi Bellstedt Datum : 2026-06-21 Schlüsselwörter : PackageUpdateInfo, Update, Modul, Regel ## VERWANDTE LINKS - [packageupdateinfo.andibellstedt.com/docs/commands/add-packageupdaterule](https://packageupdateinfo.andibellstedt.com/docs/commands/add-packageupdaterule/)