# Add-PackageUpdateRule LLMS index: [llms.txt](/llms.txt) --- ## SYNOPSIS Dodaje niestandardową regułę, która kontroluje sposób raportowania aktualizacji modułów. ## SYNTAX ### __AllParameterSets ``` Add-PackageUpdateRule [[-Id] ] [[-IncludeModuleForChecking] ] [[-ExcludeModuleFromChecking] ] [[-ReportChangeOnMajor] ] [[-ReportChangeOnMinor] ] [[-ReportChangeOnBuild] ] [[-ReportChangeOnRevision] ] [[-SettingObject] ] [-PassThru] [-WhatIf] [-Confirm] [] ``` ## ALIASES Ten cmdlet ma następujące aliasy, ## DESCRIPTION To polecenie tworzy niestandardową regułę aktualizacji dla bieżącej konfiguracji PackageUpdateInfo. Każda reguła definiuje, kiedy aktualizacja powinna być uznana za istotną do raportowania na podstawie zmian w części wersji modułu: major, minor, build lub revision. Reguły mogą również ograniczać raportowanie do konkretnych modułów poprzez uwzględnianie lub wykluczanie nazw modułów, co umożliwia tłumienie uciążliwych aktualizacji dotyczących tylko rewizji lub skupienie kontroli na wybranych modułach. Jeśli nie zostanie podany obiekt ustawień, polecenie użyje bieżącej konfiguracji modułu i zapisze tam nową regułę. ## EXAMPLES ### PRZYKŁAD 1 ```powershell PS C:\> Add-PackageUpdateRule -IncludeModuleForChecking "MyModule" -ReportChangeOnMajor $true -ReportChangeOnMinor $true -ReportChangeOnBuild $true -ReportChangeOnRevision $false ``` Dodaje regułę, która raportuje aktualizacje major, minor i build dla MyModule, jednocześnie tłumiąc zmiany dotyczące tylko rewizji. ### PRZYKŁAD 2 ```powershell PS C:\> Add-PackageUpdateRule -ExcludeModuleFromChecking "PowerShellGet","PSScriptAnalyzer" -ReportChangeOnRevision $false ``` Dodaje regułę wykluczającą dwa moduły z kontroli aktualizacji i tłumiącą aktualizacje rewizji dla pozostałych modułów. ### PRZYKŁAD 3 ```powershell PS C:\> Add-PackageUpdateRule -Id 99 -IncludeModuleForChecking "MyModule" -PassThru ``` Dodaje regułę z określonym identyfikatorem i zwraca utworzony obiekt reguły. ### PRZYKŁAD 4 ```powershell PS C:\> $settings = Get-PackageUpdateSetting; Add-PackageUpdateRule -SettingObject $settings -ExcludeModuleFromChecking "MyModule" ``` Dodaje regułę do istniejącego obiektu ustawień bez używania domyślnej konfiguracji modułu. ## PARAMETERS ### -Confirm Prosi o potwierdzenie przed zapisaniem nowej reguły. ```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 Jedna lub więcej nazw modułów, które powinny być wyłączone z kontroli aktualizacji przez tę regułę. ```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 Unikalny identyfikator reguły. ```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 Jedna lub więcej nazw modułów, które powinny być uwzględnione w kontroli aktualizacji przez tę regułę. Jeśli pominięte, reguła dotyczy wszystkich modułów. ```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 Zwraca utworzony obiekt reguły do potoku. ```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 Wskazuje, czy zmiana w części wersji build powinna wywołać raport aktualizacji. Oznacza to, że 'Get-PackageUpdateSetting' zgłosi aktualizację tylko wtedy, gdy zmieni się wersja build modułu. 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 Wskazuje, czy zmiana w części wersji major powinna wywołać raport aktualizacji. Oznacza to, że 'Get-PackageUpdateSetting' zgłosi aktualizację tylko wtedy, gdy zmieni się wersja major modułu. 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 Wskazuje, czy zmiana w części wersji minor powinna wywołać raport aktualizacji. Oznacza to, że 'Get-PackageUpdateSetting' zgłosi aktualizację tylko wtedy, gdy zmieni się wersja minor modułu. 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 Wskazuje, czy zmiana w części wersji revision powinna wywołać raport aktualizacji. Oznacza to, że 'Get-PackageUpdateSetting' zgłosi potrzebę aktualizacji, gdy zmieni się wersja revision modułu. Major Minor Build Revision ----- ----- ----- -------- 1 0 0 0 ```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 Obiekt ustawień z Get-PackageUpdateSetting, który powinien otrzymać nową regułę. Jeśli pominięty, używane są bieżące ustawienia modułu. ```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 Wyświetla, co by się stało, gdyby polecenie zostało uruchomione, bez zmiany jakiejkolwiek konfiguracji. ```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 Ten cmdlet obsługuje parametry wspólne: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction oraz -WarningVariable. Więcej informacji znajdziesz w [about_CommonParameters](https://go.microsoft.com/fwlink/?LinkID=113216). ## INPUTS ### PackageUpdate.Configuration ## OUTPUTS ### PackageUpdate.ModuleRule ## NOTES Version : 1.1.0.0 Author : Andi Bellstedt Date : 2026-06-21 Keywords : PackageUpdateInfo, Update, Module, Rule ## RELATED LINKS - [packageupdateinfo.andibellstedt.com/docs/commands/add-packageupdaterule](https://packageupdateinfo.andibellstedt.com/docs/commands/add-packageupdaterule/)