# Set-PackageUpdateRule LLMS index: [llms.txt](/llms.txt) --- ## SYNOPSIS Aktualisiert eine bestehende PackageUpdateInfo-Regel, die steuert, wie Modulversionsänderungen gemeldet werden. ## SYNTAX ### ById (Standard) ``` Set-PackageUpdateRule -Id [-IncludeModuleForChecking ] [-ExcludeModuleFromChecking ] [-ReportChangeOnMajor ] [-ReportChangeOnMinor ] [-ReportChangeOnBuild ] [-ReportChangeOnRevision ] [-SettingObject ] [-PassThru] [-WhatIf] [-Confirm] [] ``` ### ByInputObject ``` Set-PackageUpdateRule -InputObject [-IncludeModuleForChecking ] [-ExcludeModuleFromChecking ] [-ReportChangeOnMajor ] [-ReportChangeOnMinor ] [-ReportChangeOnBuild ] [-ReportChangeOnRevision ] [-SettingObject ] [-PassThru] [-WhatIf] [-Confirm] [] ``` ## 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 ```powershell 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 ```powershell 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 ```powershell $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 ```powershell 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. ```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 den Aktualisierungsprüfungen für die zu ändernde Regel ausgeschlossen werden sollen. ```yaml 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. ```yaml 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. ```yaml 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. ```yaml 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. ```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 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 ```yaml 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 ```yaml 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 ```yaml 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 ```yaml 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. ```yaml 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. ```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 ### 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 ## VERWANDTE LINKS - [packageupdateinfo.andibellstedt.com/docs/commands/set-packageupdaterule](https://packageupdateinfo.andibellstedt.com/docs/commands/set-packageupdaterule/)