Set-PackageUpdateSetting

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

SYNOPSIS

Konfiguruje zachowanie sprawdzania aktualizacji oraz preferencje raportowania dla PackageUpdateInfo.

SYNTAX

SetBehaviour

Set-PackageUpdateSetting [-ExcludeModuleFromChecking <string[]>]
 [-IncludeModuleForChecking <string[]>] [-ReportChangeOnMajor <bool>] [-ReportChangeOnMinor <bool>]
 [-ReportChangeOnBuild <bool>] [-ReportChangeOnRevision <bool>] [-UpdateCheckInterval <timespan>]
 [-LastCheck <datetime>] [-LastSuccessfulCheck <datetime>] [-InputObject <Configuration>]
 [-Path <string>] [-PassThru] [-WhatIf] [-Confirm] [<CommonParameters>]

ResetBehaviour

Set-PackageUpdateSetting [-Reset] [-Path <string>] [-PassThru] [-WhatIf] [-Confirm]
 [<CommonParameters>]

ALIASES

Ten cmdlet ma następujące aliasy,

DESCRIPTION

Konfiguruje sposób, w jaki PackageUpdateInfo ocenia zainstalowane moduły PowerShell pod kątem dostępnych aktualizacji. Użyj tego polecenia, aby kontrolować, które moduły są uwzględniane lub wykluczane ze sprawdzania aktualizacji, decydować, które zmiany wersji powinny wywoływać powiadomienia o aktualizacjach, definiować jak często mają być wykonywane kontrole aktualizacji, oraz resetować zapisane ustawienia do wartości domyślnych. Konfiguracja jest zapisywana w pliku ustawień JSON i może być stosowana bezpośrednio lub przez przekazanie istniejącego obiektu konfiguracji.

EXAMPLES

PRZYKŁAD 1

PS C:\> Set-PackageUpdateSetting -ExcludeModuleFromChecking "MyLocalOnlyModule"

Dodaje moduł “MyLocalOnlyModule” do listy wykluczonych z kontroli aktualizacji. Z założenia powinno to dotyczyć tylko modułów niedostępnych w galerii online. Ta funkcja ma na celu unikanie niepotrzebnych kontroli aktualizacji dla modułów, które nie istnieją w galerii online.

Nie otrzymasz już żadnych informacji o aktualizacjach dla modułu ‘MyLocalOnlyModule’!

Jeśli masz obawy lub problemy z wydajnością spowodowane dużą liczbą zainstalowanych modułów, lepiej stosuj praktykę uruchamiania mechanizmu sprawdzania jako zadania w PSProfile za każdym razem, gdy uruchamiasz powłokę. Opisane jest to w sekcji ‘practical-usage’ na stronie projektu na GitHub: https://github.com/AndiBellstedt/PackageUpdateInfo#practical-usage

PRZYKŁAD 2

PS C:\> Set-PackageUpdateSetting -ExcludeModuleFromChecking "Az.*"

Dodaje wszystkie moduły Az. do listy wykluczonych z kontroli aktualizacji. Powinno się to uważać za złą praktykę, ponieważ nie otrzymasz już żadnych informacji o aktualizacjach dla wszystkich modułów Az. (a one mogą się dość często zmieniać)

Jeśli masz obawy lub problemy z wydajnością spowodowane dużą liczbą zainstalowanych modułów, lepiej stosuj praktykę uruchamiania mechanizmu sprawdzania jako zadania w PSProfile za każdym razem, gdy uruchamiasz powłokę. Opisane jest to w sekcji ‘practical-usage’ na stronie projektu na GitHub: https://github.com/AndiBellstedt/PackageUpdateInfo#practical-usage

PRZYKŁAD 3

PS C:\> Set-PackageUpdateSetting -IncludeModuleForChecking "*" -ReportChangeOnMajor $true -ReportChangeOnMinor $true -ReportChangeOnBuild $true -ReportChangeOnRevision $true -UpdateCheckInterval "01:00:00"

Przywraca domyślne zachowanie sprawdzania aktualizacji i progi powiadomień, zachowując skonfigurowany interwał sprawdzania na jedną godzinę.

PRZYKŁAD 4

PS C:\> Set-PackageUpdateSetting -Reset

Resetuje ustawienia aktualizacji pakietów do wbudowanych wartości domyślnych.

PRZYKŁAD 5

PS C:\> Get-PackageUpdateSetting | Set-PackageUpdateSetting -PassThru

Aktualizuje bieżący obiekt konfiguracji w pamięci i zwraca go do potoku do dalszego przetwarzania.

PARAMETERS

-Confirm

Pyta o potwierdzenie przed wykonaniem każdej operacji zmieniającej stan.

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

Nazwy modułów, które mają być wykluczone ze sprawdzania aktualizacji w regule domyślnej.

Type: String[]
DefaultValue: ''
SupportsWildcards: false
Aliases:
- Exclude
- ExcludeModule
ParameterSets:
- Name: SetBehaviour
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-IncludeModuleForChecking

Nazwy modułów, które mają być uwzględnione w sprawdzaniu aktualizacji w regule domyślnej. Domyślnie uwzględnione są wszystkie moduły.

Wartość domyślna to: “*”

Type: String[]
DefaultValue: ''
SupportsWildcards: false
Aliases:
- Include
- IncludeModule
ParameterSets:
- Name: SetBehaviour
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-InputObject

Obiekt konfiguracji zwrócony przez Get-PackageUpdateSetting, który ma zostać zaktualizowany na miejscu.

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

-LastCheck

Znacznik czasu, kiedy rozpoczął się ostatni cykl sprawdzania aktualizacji modułów.

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

-LastSuccessfulCheck

Znacznik czasu, kiedy ostatni cykl sprawdzania aktualizacji zakończył się sukcesem.

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

-PassThru

Zwraca zaktualizowany obiekt ustawień do potoku do dalszego przetwarzania.

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

-Path

Pełna ścieżka do pliku ustawień, który ma być odczytany lub do którego mają być zapisane dane.

Jeśli ten parametr zostanie pominięty, polecenie użyje domyślnej ścieżki ustawień modułu: Linux: “$HOME/.config/powershell/PackageUpdateInfo/PackageUpdateSetting_$($PSEdition)$($PSVersionTable.PSVersion.Major).json” Windows: “$HOME\AppData\Local\Microsoft\Windows\PowerShell\PackageUpdateSetting$($PSEdition)_$($PSVersionTable.PSVersion.Major).json”

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

-ReportChangeOnBuild

Wskazuje, czy zmiana wersji build modułu powinna wywołać powiadomienie o aktualizacji w regule domyślnej.

Oznacza to, że Get-PackageUpdateSetting zgłasza potrzebę aktualizacji tylko wtedy, gdy zmienia się numer wersji build modułu.

Major Minor Build Revision

0 0 1 0

Type: Boolean
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: SetBehaviour
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-ReportChangeOnMajor

Wskazuje, czy zmiana głównej wersji modułu powinna wywołać powiadomienie o aktualizacji w regule domyślnej.

Oznacza to, że Get-PackageUpdateSetting zgłasza potrzebę aktualizacji tylko wtedy, gdy zmienia się numer głównej wersji modułu.

Major Minor Build Revision

1 0 0 0

Type: Boolean
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: SetBehaviour
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-ReportChangeOnMinor

Wskazuje, czy zmiana wersji minor modułu powinna wywołać powiadomienie o aktualizacji w regule domyślnej.

Oznacza to, że Get-PackageUpdateSetting zgłasza potrzebę aktualizacji tylko wtedy, gdy zmienia się numer wersji minor modułu.

Major Minor Build Revision

0 1 0 0

Type: Boolean
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: SetBehaviour
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-ReportChangeOnRevision

Wskazuje, czy zmiana części rewizji wersji modułu powinna wywołać powiadomienie o aktualizacji w regule domyślnej.

Oznacza to, że Get-PackageUpdateSetting zgłasza potrzebę aktualizacji tylko wtedy, gdy zmienia się numer rewizji modułu.

Major Minor Build Revision

1 0 0 0

Type: Boolean
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: SetBehaviour
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Reset

Resetuje konfigurację modułu do domyślnego zachowania.

Type: SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: ResetBehaviour
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-UpdateCheckInterval

Minimalny odstęp czasu, jaki musi upłynąć przed wykonaniem nowej kontroli aktualizacji modułu.

Wartość domyślna to: “01:00:00”

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

-WhatIf

Pokazuje, co by się stało, gdyby polecenie zostało uruchomione, bez faktycznego 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 parametry wspólne: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction oraz -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

INPUTS

PackageUpdate.Configuration

OUTPUTS

PackageUpdate.Configuration

NOTES

Version : 1.1.0.0 Author : Andi Bellstedt Date : 2026-06-21 Keywords : PackageUpdateInfo, Update, Module, Setting

RELATED LINKS

• packageupdateinfo.andibellstedt.com/docs/commands/set-packageupdatesetting