Add-PackageUpdateRule

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

SYNOPSIS

Dodaje niestandardową regułę, która kontroluje sposób raportowania aktualizacji modułów.

SYNTAX

__AllParameterSets

Add-PackageUpdateRule [[-Id] <int>] [[-IncludeModuleForChecking] <string[]>]
 [[-ExcludeModuleFromChecking] <string[]>] [[-ReportChangeOnMajor] <bool>]
 [[-ReportChangeOnMinor] <bool>] [[-ReportChangeOnBuild] <bool>] [[-ReportChangeOnRevision] <bool>]
 [[-SettingObject] <Configuration>] [-PassThru] [-WhatIf] [-Confirm] [<CommonParameters>]

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

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

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

PS C:\> Add-PackageUpdateRule -Id 99 -IncludeModuleForChecking "MyModule" -PassThru

Dodaje regułę z określonym identyfikatorem i zwraca utworzony obiekt reguły.

PRZYKŁAD 4

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.

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łę.

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.

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.

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.

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

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

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

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

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.

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.

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.

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