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]

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 głównej (major), drugorzędnej (minor), kompilacji (build) lub rewizji (revision) wersji modułu. Reguły mogą również ograniczać raportowanie do określonych 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 podano obiektu ustawień, polecenie używa bieżącej konfiguracji modułu i zapisuje 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 główne, drugorzędne i kompilacji 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łę, która wyklucza dwa moduły z kontroli aktualizacji i tłumi 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życia 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ć wykluczone 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 kompilacji powinna wywołać raport aktualizacji.

Oznacza to, że ‘Get-PackageUpdateSetting’ zgłosi aktualizację tylko wtedy, gdy zmieni się wersja kompilacji 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 głównej powinna wywołać raport aktualizacji.

Oznacza to, że ‘Get-PackageUpdateSetting’ zgłosi aktualizację tylko wtedy, gdy zmieni się wersja główna 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 drugorzędnej powinna wywołać raport aktualizacji.

Oznacza to, że ‘Get-PackageUpdateSetting’ zgłosi aktualizację tylko wtedy, gdy zmieni się wersja drugorzędna 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 rewizji powinna wywołać raport aktualizacji.

Oznacza to, że ‘Get-PackageUpdateSetting’ zgłosi potrzebę aktualizacji, gdy zmieni się wersja rewizji 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 ma 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 wspólne parametry: -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