# Set-PackageUpdateSetting LLMS index: [llms.txt](/llms.txt) --- ## SYNOPSIS Konfiguruje zachowanie sprawdzania aktualizacji oraz preferencje raportowania dla PackageUpdateInfo. ## SYNTAX ### SetBehaviour ``` Set-PackageUpdateSetting [-ExcludeModuleFromChecking ] [-IncludeModuleForChecking ] [-ReportChangeOnMajor ] [-ReportChangeOnMinor ] [-ReportChangeOnBuild ] [-ReportChangeOnRevision ] [-UpdateCheckInterval ] [-LastCheck ] [-LastSuccessfulCheck ] [-InputObject ] [-Path ] [-PassThru] [-WhatIf] [-Confirm] [] ``` ### ResetBehaviour ``` Set-PackageUpdateSetting [-Reset] [-Path ] [-PassThru] [-WhatIf] [-Confirm] [] ``` ## 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 ```powershell 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 ```powershell 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 ```powershell 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 ```powershell PS C:\> Set-PackageUpdateSetting -Reset ``` Resetuje ustawienia aktualizacji pakietów do wbudowanych wartości domyślnych. ### PRZYKŁAD 5 ```powershell 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. ```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 Nazwy modułów, które mają być wykluczone ze sprawdzania aktualizacji w regule domyślnej. ```yaml 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: "*" ```yaml 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. ```yaml 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. ```yaml 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. ```yaml 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. ```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: '' ``` ### -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" ```yaml 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 ```yaml 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 ```yaml 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 ```yaml 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 ```yaml 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. ```yaml 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" ```yaml 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. ```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. Aby uzyskać więcej informacji, zobacz [about_CommonParameters](https://go.microsoft.com/fwlink/?LinkID=113216). ## 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](https://packageupdateinfo.andibellstedt.com/docs/commands/set-packageupdatesetting/)