Set-PackageUpdateRule

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

SYNOPSIS

Aktualizuje istniejącą regułę PackageUpdateInfo, która kontroluje sposób raportowania zmian wersji modułu.

SYNTAX

ById (Domyślnie)

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

ByInputObject

Set-PackageUpdateRule -InputObject <ModuleRule[]> [-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

Ten cmdlet modyfikuje istniejącą regułę aktualizacji przechowywaną w konfiguracji PackageUpdateInfo, tak aby kontrole aktualizacji mogły być zawężone lub rozszerzone dla konkretnych modułów.
Możesz go użyć, aby uwzględnić lub wykluczyć moduły z wykrywania aktualizacji, kontrolować, które części wersji wywołują raport o aktualizacji oraz zapisać te zmiany reguł z powrotem do aktywnego pliku ustawień.
Polecenie działa z regułą identyfikowaną przez Id lub z obiektem reguły dostarczonym przez InputObject i może zwrócić zaktualizowaną regułę, gdy zostanie określony parametr -PassThru.

EXAMPLES

PRZYKŁAD 1

PS C:\> Set-PackageUpdateRule -Id 3 -IncludeModuleForChecking 'MyModule' -ReportChangeOnMajor $true -ReportChangeOnMinor $true -ReportChangeOnBuild $true -ReportChangeOnRevision $false -PassThru

Aktualizuje regułę 3 tak, że MyModule jest oceniany wyraźnie, a raportowane są tylko zmiany główne, mniejsze i build.

PRZYKŁAD 2

PS C:\> Get-PackageUpdateRule -Id 7 | Set-PackageUpdateRule -ExcludeModuleFromChecking 'AzureTools' -ReportChangeOnRevision $false

Pobiera regułę o Id 7 z potoku i wyłącza raportowanie aktualizacji oparte na rewizji dla AzureTools, pozostawiając regułę zapisaną w bieżących ustawieniach.

PRZYKŁAD 3

$rule = Get-PackageUpdateRule -Id 12
PS C:\> Set-PackageUpdateRule -InputObject $rule -IncludeModuleForChecking 'PowershellGet','PSReadLine' -ReportChangeOnMinor $false -ReportChangeOnBuild $false

Ładuje istniejący obiekt reguły, rozszerza uwzględnione moduły i aktualizuje regułę tak, aby tylko zmiany główne i rewizje były traktowane jako wymagające aktualizacji.

PRZYKŁAD 4

PS C:\> Set-PackageUpdateRule -Id 5 -ReportChangeOnMajor $false -ReportChangeOnMinor $false -ReportChangeOnBuild $false -ReportChangeOnRevision $true -WhatIf

Pokazuje efekt zmiany reguły 5, aby raportowała tylko aktualizacje oparte na rewizji, bez faktycznego zapisu zmiany na dysku.

PARAMETERS

-Confirm

Pyta o potwierdzenie przed zapisaniem zmienionych danych reguły do pliku ustawień.

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 mają być wyłączone z kontroli aktualizacji dla zmienianej reguły.

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

Numeryczny identyfikator reguły do modyfikacji.

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

Jedna lub więcej nazw modułów, które mają być uwzględnione w kontroli aktualizacji dla zmienianej reguły.
Jeśli pominięte, reguła zachowuje domyślne zachowanie oceny wszystkich modułów.

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

Obiekt reguły do aktualizacji.
Przydatne, gdy masz już regułę z Get-PackageUpdateRule i chcesz ją zmienić bez odwoływania się do jej Id.

Type: ModuleRule[]
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: ByInputObject
  Position: Named
  IsRequired: true
  ValueFromPipeline: true
  ValueFromPipelineByPropertyName: true
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-PassThru

Zwraca zaktualizowany obiekt reguły do potoku po zapisaniu zmiany w pliku ustawień.

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

Kontroluje, czy zmiana w części wersji build powoduje, że reguła zgłasza potrzebę aktualizacji.

Raportuj, gdy zmieni się wersja build modułu

Oznacza to, że ‘Get-PackageUpdateSetting’ zgłasza potrzebę aktualizacji,
tylko gdy zmieni się wersja build modułu.

Major Minor Build Revision

0 0 1 0

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

Kontroluje, czy zmiana w części wersji major powoduje, że reguła zgłasza potrzebę aktualizacji.

Raportuj, gdy zmieni się wersja major modułu

Oznacza to, że ‘Get-PackageUpdateSetting’ zgłasza potrzebę aktualizacji,
tylko gdy zmieni się wersja major modułu.

Major Minor Build Revision

1 0 0 0

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

Kontroluje, czy zmiana w części wersji minor powoduje, że reguła zgłasza potrzebę aktualizacji.

Raportuj, gdy zmieni się wersja minor modułu

Oznacza to, że ‘Get-PackageUpdateSetting’ zgłasza potrzebę aktualizacji,
tylko gdy zmieni się wersja minor modułu.

Major Minor Build Revision

0 1 0 0

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

Kontroluje, czy zmiana w części wersji revision powoduje, że reguła zgłasza potrzebę aktualizacji.

Raportuj, gdy zmieni się część revision modułu

Oznacza to, że ‘Get-PackageUpdateSetting’ zgłasza potrzebę aktualizacji,
tylko gdy zmieni się wersja revision modułu.

Major Minor Build Revision

0 0 0 1

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

Obiekt konfiguracji PackageUpdateInfo do aktualizacji.
Jeśli pominięty, cmdlet używa bieżących ustawień modułu z Get-PackageUpdateSetting.

Type: Configuration
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: true
  ValueFromPipelineByPropertyName: true
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-WhatIf

Pokazuje, co by się stało, gdyby polecenie zostało uruchomione, bez wprowadzania zmian.

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

System.Int32

PackageUpdate.ModuleRule[]

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/set-packageupdaterule