To wielostronicowy widok tej sekcji do wydrukowania. Kliknij aby wydrukować.
Tutaj znajdziesz odniesienie do wszystkich poleceń w module. To odniesienie zostało zaprojektowane tak, aby pomóc Ci szybko znaleźć potrzebne polecenie i zrozumieć, jak z niego skutecznie korzystać.
Klikając na polecenie, zostaniesz przeniesiony do szczegółowej strony, która zawiera wyczerpujące informacje na temat polecenia, w tym składnię, parametry, przykłady oraz wszelkie dodatkowe uwagi lub wskazówki dotyczące użycia.
Dodaje niestandardową regułę, która kontroluje sposób raportowania aktualizacji modułów.
Add-PackageUpdateRule [[-Id] <int>] [[-IncludeModuleForChecking] <string[]>]
[[-ExcludeModuleFromChecking] <string[]>] [[-ReportChangeOnMajor] <bool>]
[[-ReportChangeOnMinor] <bool>] [[-ReportChangeOnBuild] <bool>] [[-ReportChangeOnRevision] <bool>]
[[-SettingObject] <Configuration>] [-PassThru] [-WhatIf] [-Confirm] [<CommonParameters>]
Ten cmdlet ma następujące aliasy,
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łę.
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.
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.
PS C:\> Add-PackageUpdateRule -Id 99 -IncludeModuleForChecking "MyModule" -PassThru
Dodaje regułę z określonym identyfikatorem i zwraca utworzony obiekt reguły.
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.
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: ''
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: ''
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: ''
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: ''
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: ''
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: ''
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: ''
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: ''
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: ''
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: ''
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: ''
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.
Version : 1.1.0.0
Author : Andi Bellstedt
Date : 2026-06-21
Keywords : PackageUpdateInfo, Update, Module, Rule
Eksportuje obiekty PackageUpdateInfo do pliku XML, JSON lub CSV.
Export-PackageUpdateInfo [[-Path] <string>] -InputObject <Info[]> [-OutputFormat <string>]
[-Encoding <string>] [-Force] [-Append] [-IncludeTimeStamp] [-PassThru] [-WhatIf] [-Confirm]
[<CommonParameters>]
Ten cmdlet ma następujące aliasy,
Zapisuje obiekty PackageUpdateInfo wygenerowane przez Get-PackageUpdateInfo do strukturalnego pliku danych w celu zachowania, raportowania lub późniejszej automatyzacji. Cmdlet obsługuje formaty wyjściowe XML, JSON i CSV, opcjonalne dodanie znacznika czasu oraz tryb dopisywania do istniejącego pliku. Obsługuje także tworzenie docelowego katalogu w razie potrzeby i może przekazywać wyeksportowane obiekty dalej w potoku.
PS C:\> Get-PackageUpdateInfo | Export-PackageUpdateInfo
Eksportuje bieżące obiekty PackageUpdateInfo do domyślnego pliku XML.
PS C:\> Get-PackageUpdateInfo | Export-PackageUpdateInfo -OutputFormat JSON -Path .\updates.json -IncludeTimeStamp -PassThru
Eksportuje dane jako JSON, dodaje znacznik czasu do każdego rekordu i przekazuje obiekty dalej w potoku.
PS C:\> Get-PackageUpdateInfo | Export-PackageUpdateInfo -OutputFormat CSV -Path .\updates.csv -Append -Force
Dopisuje wyeksportowane dane do pliku CSV i tworzy docelowy katalog, jeśli nie istnieje.
PS C:\> Get-PackageUpdateInfo | Export-PackageUpdateInfo -Path C:\Temp\PackageUpdateInfo.xml -Encoding utf8
Eksportuje bieżące dane do niestandardowego pliku XML z użyciem kodowania UTF-8.
Dodaje wyeksportowane informacje do istniejącego pliku zamiast zastępować jego aktualną zawartość. Jest to obsługiwane dla formatów JSON i CSV, a ignorowane dla formatu XML.
Type: SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
Position: Named
IsRequired: false
ValueFromPipeline: false
ValueFromPipelineByPropertyName: false
ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''
Jeśli ten przełącznik jest włączony, zostaniesz poproszony 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: ''
Kodowanie pliku używane podczas tworzenia lub aktualizacji pliku eksportu.
Type: String
DefaultValue: default
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
Position: Named
IsRequired: false
ValueFromPipeline: false
ValueFromPipelineByPropertyName: false
ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''
Tworzy katalog nadrzędny dla docelowego pliku, jeśli jeszcze nie istnieje i jeśli podana ścieżka jest poza domyślną lokalizacją.
Type: SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
Position: Named
IsRequired: false
ValueFromPipeline: false
ValueFromPipelineByPropertyName: false
ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''
Dodaje właściwość TimeStamp do każdego eksportowanego rekordu, aby eksport zawierał czas eksportu dla każdego wpisu.
Type: SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
Position: Named
IsRequired: false
ValueFromPipeline: false
ValueFromPipelineByPropertyName: false
ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''
Jeden lub więcej obiektów PackageUpdateInfo do eksportu. Ten parametr akceptuje dane z potoku z Get-PackageUpdateInfo i podobnych poleceń.
Type: Info[]
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
Position: Named
IsRequired: true
ValueFromPipeline: true
ValueFromPipelineByPropertyName: true
ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''
Format wyjściowy używany do eksportu. Obsługiwane wartości to “XML”, “JSON” i “CSV”.
Type: String
DefaultValue: XML
SupportsWildcards: false
Aliases:
- Format
ParameterSets:
- Name: (All)
Position: Named
IsRequired: false
ValueFromPipeline: false
ValueFromPipelineByPropertyName: false
ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''
Przesyła wyeksportowane obiekty dalej w potoku po zapisaniu ich na dysku.
Type: SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
Position: Named
IsRequired: false
ValueFromPipeline: false
ValueFromPipelineByPropertyName: false
ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''
Ścieżka docelowego pliku dla wyeksportowanych danych. Podaj ścieżkę do pliku, a nie do katalogu.
Domyślna wartość ścieżki to: Linux: “$HOME/.config/powershell/PackageUpdateInfo/PackageUpdateInfo_$($PSEdition)$($PSVersionTable.PSVersion.Major).xml” Windows: “$HOME\AppData\Local\Microsoft\Windows\PowerShell\PackageUpdateInfo$($PSEdition)_$($PSVersionTable.PSVersion.Major).xml”
Type: String
DefaultValue: ''
SupportsWildcards: false
Aliases:
- FullName
- FilePath
ParameterSets:
- Name: (All)
Position: 0
IsRequired: false
ValueFromPipeline: false
ValueFromPipelineByPropertyName: false
ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''
Jeśli ten przełącznik jest włączony, nie wykonuje żadnych działań, ale wyświetla komunikaty informujące, co by się stało, gdyby polecenie zostało uruchomione.
Type: SwitchParameter
DefaultValue: ''
SupportsWildcards: false
Aliases:
- wi
ParameterSets:
- Name: (All)
Position: Named
IsRequired: false
ValueFromPipeline: false
ValueFromPipelineByPropertyName: false
ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''
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.
Wersja : 1.1.0.0 Autor : Andi Bellstedt Data : 2026-06-21 Słowa kluczowe : PackageUpdateInfo, Update, Module, Export
Pobiera informacje o aktualizacjach dla zainstalowanych modułów PowerShell i identyfikuje moduły, dla których dostępne są nowsze wersje online.
Get-PackageUpdateInfo [-Name <string[]>] [-Repository <string[]>] [-ShowOnlyNeededUpdate]
[-ShowToastNotification] [-Force] [<CommonParameters>]
Get-PackageUpdateInfo [-Name <string[]>] [-Repository <string[]>] [-ShowOnlyNeededUpdate]
[-ShowToastNotification] [-CurrentUser] [-Force] [<CommonParameters>]
Get-PackageUpdateInfo [-Name <string[]>] [-Repository <string[]>] [-ShowOnlyNeededUpdate]
[-ShowToastNotification] [-AllUsers] [-Force] [<CommonParameters>]
Ten cmdlet ma następujące aliasy,
Get-PackageUpdateInfo sprawdza lokalnie zainstalowane moduły PowerShell, porównuje ich zainstalowane wersje z wersjami dostępnymi w jednym lub więcej skonfigurowanych repozytoriach i zwraca szczegółowe informacje o aktualizacjach.
Polecenie może filtrować wyniki do modułów, które wymagają aktualizacji, ograniczać wyszukiwanie do ścieżek modułów bieżącego użytkownika lub wszystkich użytkowników oraz opcjonalnie wyświetlać powiadomienia toast systemu Windows, gdy dostępne są aktualizacje.
Respektuje również zasady sprawdzania aktualizacji modułu oraz skonfigurowany interwał sprawdzania aktualizacji, chyba że wyraźnie wymusisz świeże sprawdzenie.
Sprawdzanie odbywa się za pomocą PowerShellGet w wersji 2 lub 3, w zależności od dostępności modułu Microsoft.PowerShell.PSResourceGet w systemie.
PS C:\> Get-PackageUpdateInfo
Pobiera informacje o aktualizacjach dla wszystkich modułów wykrytych na podstawie skonfigurowanych reguł dołączania i dostępnych repozytoriów. Wynik pokazuje zainstalowaną wersję, najnowszą wersję online oraz czy aktualizacja jest potrzebna. Wyjście może wyglądać tak:
Name Repository VersionInstalled VersionOnline NeedUpdate Path
PSReadline PSGallery 1.2 1.2 False C:\Program Files\WindowsPowerShell\Modules\PSReadline Pester PSGallery 4.4.0 4.4.2 True C:\Program Files\WindowsPowerShell\Modules\Pester
PS C:\> Get-PackageUpdateInfo -ShowOnlyNeededUpdate
Zwraca tylko te moduły, dla których dostępna jest nowsza wersja online, ułatwiając skupienie się na modułach, które faktycznie wymagają uwagi. To przefiltruje wynik, pokazując tylko moduły, gdzie NeedUpdate jest True. Wyjście może wyglądać tak:
Name Repository VersionInstalled VersionOnline NeedUpdate Path
Pester PSGallery 4.4.0 4.4.2 True C:\Program Files\WindowsPowerShell\Modules\Pester
PS C:\> "Pester", "PSReadline" | Get-PackageUpdateInfo
Akceptuje nazwy modułów z potoku i zwraca informacje o aktualizacjach dla każdego żądanego modułu. Działa to również z obiektami, które udostępniają właściwość Name, takimi jak moduły zwracane przez Get-Module.
PS C:\> Get-PackageUpdateInfo -CurrentUser -ShowOnlyNeededUpdate
Sprawdza tylko moduły zainstalowane w profilu bieżącego użytkownika i wyświetla tylko te moduły, dla których dostępna jest nowsza wersja online.
Ogranicza wyszukiwanie do modułów zainstalowanych we współdzielonych lokalizacjach modułów dla wszystkich użytkowników lub systemowych.
Pamiętaj, że do aktualizacji tych modułów wymagane są uprawnienia administratora.
Type: SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: AllUsers
Position: Named
IsRequired: false
ValueFromPipeline: false
ValueFromPipelineByPropertyName: false
ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''
Ogranicza wyszukiwanie do modułów zainstalowanych w lokalizacji profilu bieżącego użytkownika.
Jest to przydatne, jeśli uruchamiasz bez uprawnień administratora, co zawsze powinno być twoim domyślnym wyborem pracy.
Type: SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: CurrentUser
Position: Named
IsRequired: false
ValueFromPipeline: false
ValueFromPipelineByPropertyName: false
ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''
Pomija skonfigurowany interwał sprawdzania aktualizacji i wykonuje natychmiast świeże porównanie.
Type: SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
Position: Named
IsRequired: false
ValueFromPipeline: false
ValueFromPipelineByPropertyName: false
ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''
Jedna lub więcej nazw modułów do sprawdzenia. Jeśli ten parametr jest pominięty, funkcja używa skonfigurowanych reguł dołączania, aby określić, które moduły powinny być sprawdzane.
Type: String[]
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
Position: Named
IsRequired: false
ValueFromPipeline: true
ValueFromPipelineByPropertyName: true
ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''
Jedno lub więcej repozytoriów PowerShell do zapytania o dostępne wersje modułów. Jeśli pominięte, polecenie używa repozytoriów dostępnych w lokalnym systemie.
Type: String[]
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
Position: Named
IsRequired: false
ValueFromPipeline: false
ValueFromPipelineByPropertyName: false
ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''
Ukrywa moduły, które są już aktualne, i zwraca tylko moduły, dla których dostępna jest aktualizacja.
Type: SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
Position: Named
IsRequired: false
ValueFromPipeline: false
ValueFromPipelineByPropertyName: false
ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''
Wyświetla powiadomienia toast systemu Windows dla modułów, które mają dostępne aktualizacje, gdy system obsługuje tę funkcję.
Type: SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases:
- ToastNotification
- Notify
ParameterSets:
- Name: (All)
Position: Named
IsRequired: false
ValueFromPipeline: false
ValueFromPipelineByPropertyName: false
ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''
Ten cmdlet obsługuje wspólne parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction oraz -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.
Version : 1.2.0.0 Author : Andi Bellstedt Date : 2026-06-21 Keywords : PackageUpdateInfo, Update, Module
Pobiera jedną lub więcej reguł aktualizacji pakietów używanych do kontrolowania sprawdzania aktualizacji modułów i raportowania.
Get-PackageUpdateRule [-IncludeModuleForChecking <string>] [-ExcludeModuleFromChecking <string>]
[-IncludeDefaultRule] [-SettingObject <Configuration>] [<CommonParameters>]
Get-PackageUpdateRule -Id <int[]> [-SettingObject <Configuration>] [<CommonParameters>]
Ten cmdlet ma następujące aliasy,
Pobiera niestandardowe reguły definiujące, jak moduły są obsługiwane podczas sprawdzania aktualizacji i raportowania. Możesz filtrować reguły według identyfikatora, wzorców włączania lub wyłączania modułów albo dołączyć domyślną regułę z aktywnego obiektu ustawień, aby porównać niestandardowe zachowanie z wbudowanym zachowaniem zapasowym.
PS C:\> Get-PackageUpdateRule
Pobiera wszystkie niestandardowe reguły aktualnie skonfigurowane do obsługi aktualizacji pakietów.
PS C:\> Get-PackageUpdateRule -Id 1, 2
Pobiera niestandardowe reguły o podanych identyfikatorach.
PS C:\> Get-PackageUpdateRule -ExcludeModuleFromChecking 'Pester'
Pobiera niestandardowe reguły, które wykluczają Pester ze sprawdzania aktualizacji.
PS C:\> Get-PackageUpdateRule -IncludeModuleForChecking 'PackageManagement' -IncludeDefaultRule
Pobiera niestandardowe reguły, które uwzględniają PackageManagement do sprawdzania aktualizacji oraz zwraca również regułę domyślną.
Filtruje zwracane reguły do tych, które wykluczają określoną nazwę modułu ze sprawdzania aktualizacji.
Type: String
DefaultValue: ''
SupportsWildcards: false
Aliases:
- Exclude
- ExcludeModule
ParameterSets:
- Name: ShowAll
Position: Named
IsRequired: false
ValueFromPipeline: false
ValueFromPipelineByPropertyName: false
ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''
Określa jeden lub więcej identyfikatorów reguł do pobrania.
Type: Int32[]
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: ById
Position: Named
IsRequired: true
ValueFromPipeline: true
ValueFromPipelineByPropertyName: true
ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''
Dodaje do wyniku domyślną regułę z dostarczonego lub aktywnego obiektu ustawień oprócz wszelkich reguł niestandardowych.
Type: SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: ShowAll
Position: Named
IsRequired: false
ValueFromPipeline: false
ValueFromPipelineByPropertyName: false
ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''
Filtruje zwracane reguły do tych, które uwzględniają określoną nazwę modułu do sprawdzania aktualizacji. Domyślnie wszystkie moduły są uwzględniane, gdy nie podano filtra.
Wartość domyślna to: “*”
Type: String
DefaultValue: ''
SupportsWildcards: false
Aliases:
- Include
- IncludeModule
ParameterSets:
- Name: ShowAll
Position: Named
IsRequired: false
ValueFromPipeline: false
ValueFromPipelineByPropertyName: false
ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''
Określa obiekt ustawień zwrócony przez Get-PackageUpdateSetting. Jeśli ten parametr zostanie pominięty, polecenie użyje bieżącego obiektu ustawień modułu.
Type: Configuration
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
Position: Named
IsRequired: false
ValueFromPipeline: true
ValueFromPipelineByPropertyName: true
ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''
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.
Wersja : 1.1.0.0 Autor : Andi Bellstedt Data : 2026-06-21 Słowa kluczowe : PackageUpdateInfo, Aktualizacja, Moduł, Reguła
Pobiera konfigurację PackageUpdateInfo z pliku ustawień modułu.
Get-PackageUpdateSetting [[-Path] <string>] [<CommonParameters>]
Ten cmdlet ma następujące aliasy,
Odczytuje plik konfiguracyjny PackageUpdateInfo i zwraca bieżące ustawienia zachowania modułu jako obiekt PackageUpdate.Configuration.
Zwrócony obiekt zawiera domyślne i niestandardowe reguły aktualizacji, interwał sprawdzania aktualizacji oraz znaczniki czasu ostatnich i ostatnich udanych sprawdzeń.
PS C:\> Get-PackageUpdateSetting
Pobiera bieżące ustawienia PackageUpdateInfo z domyślnego pliku konfiguracyjnego.
PS C:\> Get-PackageUpdateSetting -Path "C:\temp\PackageUpdateInfo.json"
Odczytuje konfigurację PackageUpdateInfo z określonego pliku ustawień.
PS C:\> Get-PackageUpdateSetting | Select-Object -ExpandProperty UpdateCheckInterval
Zwraca skonfigurowany interwał sprawdzania aktualizacji z bieżących ustawień.
Pełna ścieżka do pliku ustawień do odczytania.
Ten parametr jest opcjonalny.
Jeśli zostanie pominięty, funkcja użyje domyślnej ścieżki ustawień modułu:
Linux: “$HOME/.config/powershell/PackageUpdateInfo/PackageUpdateInfo_$($PSEdition)$($PSVersionTable.PSVersion.Major).json”
Windows: “$HOME\AppData\Local\Microsoft\Windows\PowerShell\PackageUpdateInfo$($PSEdition)_$($PSVersionTable.PSVersion.Major).json”
Type: String
DefaultValue: $script:ModuleSettingPath
SupportsWildcards: false
Aliases:
- FullName
- FilePath
ParameterSets:
- Name: (All)
Position: 0
IsRequired: false
ValueFromPipeline: false
ValueFromPipelineByPropertyName: false
ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''
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.
Version : 1.1.0.0
Author : Andi Bellstedt
Date : 2026-06-21
Keywords : PackageUpdateInfo, Update, Module, Setting
Importuje informacje o aktualizacjach pakietów z wcześniej wyeksportowanego pliku danych.
Import-PackageUpdateInfo [[-Path] <string>] [-ShowToastNotification] [-InputFormat <string>]
[-Encoding <string>] [-WhatIf] [-Confirm] [<CommonParameters>]
Ten cmdlet ma następujące aliasy,
Importuje informacje o aktualizacjach pakietów z pliku danych, który został wcześniej wyeksportowany za pomocą Export-PackageUpdateInfo. Polecenie odczytuje rekordy z plików XML, JSON lub CSV i konwertuje je na obiekty PackageUpdateInfo do dalszego wykorzystania, wyświetlania lub przetwarzania. Na żądanie może również wyświetlać powiadomienia toast systemu Windows dla modułów wymagających aktualizacji.
PS C:\> Import-PackageUpdateInfo
Importuje domyślny plik informacji o aktualizacjach pakietów dla bieżącego środowiska PowerShell.
PS C:\> Import-PackageUpdateInfo -Path C:\temp\packageupdateinfo.xml
Importuje informacje o aktualizacjach z określonego pliku XML.
PS C:\> Import-PackageUpdateInfo -Path .\updates.json -InputFormat JSON
Importuje informacje o aktualizacjach z pliku JSON, używając określonego formatu wejściowego.
PS C:\> Import-PackageUpdateInfo -Path .\updates.csv -InputFormat CSV -ShowToastNotification
Importuje informacje o aktualizacjach z pliku CSV i wyświetla powiadomienia toast dla modułów wymagających aktualizacji.
Jeśli ten przełącznik jest włączony, przed wykonaniem jakichkolwiek operacji zmieniających stan zostaniesz poproszony o potwierdzenie.
Type: SwitchParameter
DefaultValue: ''
SupportsWildcards: false
Aliases:
- cf
ParameterSets:
- Name: (All)
Position: Named
IsRequired: false
ValueFromPipeline: false
ValueFromPipelineByPropertyName: false
ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''
Określa kodowanie pliku używane podczas odczytu pliku wejściowego.
Type: String
DefaultValue: default
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
Position: Named
IsRequired: false
ValueFromPipeline: false
ValueFromPipelineByPropertyName: false
ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''
Określa format importowanego pliku danych. Obsługiwane wartości to “XML”, “JSON” oraz “CSV”.
Type: String
DefaultValue: XML
SupportsWildcards: false
Aliases:
- Format
ParameterSets:
- Name: (All)
Position: Named
IsRequired: false
ValueFromPipeline: false
ValueFromPipelineByPropertyName: false
ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''
Ścieżka do pliku danych do importu. Podaj prawidłową ścieżkę do pliku. Jeśli pominięto, polecenie użyje domyślnego pliku danych modułu dla bieżącej edycji i wersji PowerShell.
Domyślne ścieżki to: Linux: “$HOME/.config/powershell/PackageUpdateInfo/PackageUpdateInfo_$($PSEdition)$($PSVersionTable.PSVersion.Major).xml” Windows: “$HOME\AppData\Local\Microsoft\Windows\PowerShell\PackageUpdateInfo$($PSEdition)_$($PSVersionTable.PSVersion.Major).xml”
Type: String
DefaultValue: ''
SupportsWildcards: false
Aliases:
- FullName
- FilePath
ParameterSets:
- Name: (All)
Position: 0
IsRequired: false
ValueFromPipeline: true
ValueFromPipelineByPropertyName: true
ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''
Wyświetla powiadomienia toast systemu Windows z informacjami o notatkach do wydania dla modułów wymagających aktualizacji.
Type: SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases:
- ToastNotification
- Notify
ParameterSets:
- Name: (All)
Position: Named
IsRequired: false
ValueFromPipeline: false
ValueFromPipelineByPropertyName: false
ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''
Jeśli ten przełącznik jest włączony, nie zostaną wykonane żadne działania, ale zostaną wyświetlone komunikaty informujące, co by się stało, gdyby polecenie zostało uruchomione.
Type: SwitchParameter
DefaultValue: ''
SupportsWildcards: false
Aliases:
- wi
ParameterSets:
- Name: (All)
Position: Named
IsRequired: false
ValueFromPipeline: false
ValueFromPipelineByPropertyName: false
ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''
Ten cmdlet obsługuje wspólne parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction oraz -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.
Version : 1.1.0.0 Author : Andi Bellstedt Date : 2026-06-21 Keywords : PackageUpdateInfo, Update, Module, Info
Usuwa jedną lub więcej niestandardowych reguł obsługi aktualizacji z konfiguracji aktualizacji pakietu.
Remove-PackageUpdateRule -Id <int[]> [-Force] [-PassThru] [-SettingObject <Configuration>] [-WhatIf]
[-Confirm] [<CommonParameters>]
Remove-PackageUpdateRule -InputObject <ModuleRule[]> [-Force] [-PassThru]
[-SettingObject <Configuration>] [-WhatIf] [-Confirm] [<CommonParameters>]
Ten cmdlet ma następujące aliasy,
Usuwa istniejące niestandardowe reguły definiujące, jak określone moduły PowerShell powinny być obsługiwane podczas sprawdzania aktualizacji i raportowania. Polecenie może usuwać reguły według identyfikatora reguły, przez przekazanie obiektów reguł z Get-PackageUpdateRule, lub przez aktualizację obiektu ustawień zawierającego kolekcję reguł.
Po usunięciu reguł zaktualizowana konfiguracja jest zapisywana z powrotem do pliku ustawień, aby zmiana była trwała. Użyj -PassThru, aby zwrócić usunięte obiekty reguł do potoku.
PS C:\> Get-PackageUpdateRule | Remove-PackageUpdateRule
Usuwa wszystkie niestandardowe reguły aktualizacji z bieżących ustawień modułu.
PS C:\> Remove-PackageUpdateRule -Id 12
Usuwa niestandardową regułę o identyfikatorze 12 z bieżącej konfiguracji.
$rules = Get-PackageUpdateRule -Name "Microsoft.PowerShell.Utility"
PS C:\> $rules | Remove-PackageUpdateRule -PassThru
Usuwa pasujące reguły i zwraca usunięte obiekty reguł do potoku.
$settings = Get-PackageUpdateSetting
PS C:\> Remove-PackageUpdateRule -Id 3 -SettingObject $settings -Force
Usuwa konkretną regułę bez pytania o potwierdzenie i zapisuje zaktualizowane ustawienia na dysku.
Jeśli ten przełącznik jest włączony, zostaniesz poproszony o potwierdzenie przed wykonaniem jakichkolwiek operacji zmieniających 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: ''
Pomija monit o potwierdzenie i usuwa regułę natychmiast.
Type: SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
Position: Named
IsRequired: false
ValueFromPipeline: false
ValueFromPipelineByPropertyName: false
ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''
Identyfikator reguły do usunięcia. Akceptuje jeden lub więcej identyfikatorów reguł.
Type: Int32[]
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: ById
Position: Named
IsRequired: true
ValueFromPipeline: true
ValueFromPipelineByPropertyName: true
ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''
Jeden lub więcej obiektów reguł do usunięcia. Zazwyczaj są to obiekty zwracane przez Get-PackageUpdateRule.
Type: ModuleRule[]
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: ByInputObject
Position: Named
IsRequired: true
ValueFromPipeline: true
ValueFromPipelineByPropertyName: true
ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''
Zwraca usunięte obiekty reguł 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: ''
Obiekt konfiguracji zawierający kolekcję reguł. Jeśli ten parametr nie zostanie podany, polecenie użyje 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: ''
Jeśli ten przełącznik jest włączony, nie zostaną wykonane żadne działania, ale zostaną wyświetlone komunikaty informujące, co by się stało, gdyby polecenie zostało uruchomione.
Type: SwitchParameter
DefaultValue: ''
SupportsWildcards: false
Aliases:
- wi
ParameterSets:
- Name: (All)
Position: Named
IsRequired: false
ValueFromPipeline: false
ValueFromPipelineByPropertyName: false
ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''
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.
Version : 1.1.0.0 Author : Andi Bellstedt Date : 2026-06-21 Keywords : PackageUpdateInfo, Update, Module, Rule
Aktualizuje istniejącą regułę PackageUpdateInfo, która kontroluje sposób raportowania zmian wersji modułu.
Set-PackageUpdateRule -Id <int> [-IncludeModuleForChecking <string[]>]
[-ExcludeModuleFromChecking <string[]>] [-ReportChangeOnMajor <bool>] [-ReportChangeOnMinor <bool>]
[-ReportChangeOnBuild <bool>] [-ReportChangeOnRevision <bool>] [-SettingObject <Configuration>]
[-PassThru] [-WhatIf] [-Confirm] [<CommonParameters>]
Set-PackageUpdateRule -InputObject <ModuleRule[]> [-IncludeModuleForChecking <string[]>]
[-ExcludeModuleFromChecking <string[]>] [-ReportChangeOnMajor <bool>] [-ReportChangeOnMinor <bool>]
[-ReportChangeOnBuild <bool>] [-ReportChangeOnRevision <bool>] [-SettingObject <Configuration>]
[-PassThru] [-WhatIf] [-Confirm] [<CommonParameters>]
Ten cmdlet ma następujące aliasy,
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.
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.
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.
$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.
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.
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: ''
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: ''
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: ''
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: ''
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: ''
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: ''
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: ''
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: ''
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: ''
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: ''
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: ''
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: ''
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.
Version : 1.1.0.0
Author : Andi Bellstedt
Date : 2026-06-21
Keywords : PackageUpdateInfo, Update, Module, Rule
Konfiguruje zachowanie sprawdzania aktualizacji oraz preferencje raportowania dla PackageUpdateInfo.
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>]
Set-PackageUpdateSetting [-Reset] [-Path <string>] [-PassThru] [-WhatIf] [-Confirm]
[<CommonParameters>]
Ten cmdlet ma następujące aliasy,
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.
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
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
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ę.
PS C:\> Set-PackageUpdateSetting -Reset
Resetuje ustawienia aktualizacji pakietów do wbudowanych wartości domyślnych.
PS C:\> Get-PackageUpdateSetting | Set-PackageUpdateSetting -PassThru
Aktualizuje bieżący obiekt konfiguracji w pamięci i zwraca go do potoku do dalszego przetwarzania.
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: ''
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: ''
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: ''
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: ''
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: ''
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: ''
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: ''
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: ''
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: ''
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: ''
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: ''
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: ''
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: ''
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: ''
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: ''
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.
Version : 1.1.0.0 Author : Andi Bellstedt Date : 2026-06-21 Keywords : PackageUpdateInfo, Update, Module, Setting
Wyświetla notatki wydania dla jednego lub więcej modułów PowerShell.
Show-PackageUpdateReleaseNote [[-InputObject] <Info[]>] [-WhatIf] [-Confirm] [<CommonParameters>]
Show-PackageUpdateReleaseNote [[-Module] <psmoduleinfo[]>] [-WhatIf] [-Confirm] [<CommonParameters>]
Ten cmdlet ma następujące aliasy,
Pobiera i wyświetla notatki wydania dla obiektów informacji o module wygenerowanych przez Get-PackageUpdateInfo lub Import-PackageUpdateInfo albo dla obiektów modułu zwróconych przez Get-Module.
Gdy notatki wydania są dostępne jako URL, cmdlet próbuje rozwiązać i pobrać zawartość, aby notatki mogły być bezpośrednio przedstawione wywołującemu.
PS C:\> Get-PackageUpdateInfo | Show-PackageUpdateReleaseNote
Pobiera notatki wydania dla każdego modułu zwróconego przez Get-PackageUpdateInfo.
PS C:\> Get-Module PackageUpdateInfo | Show-PackageUpdateReleaseNote
Pobiera notatki wydania dla modułu PackageUpdateInfo z bieżącej sesji PowerShell.
PS C:\> Get-PackageUpdateInfo -Name PackageUpdateInfo | Show-PackageUpdateReleaseNote
Wyświetla notatki wydania dla konkretnego modułu, korzystając z wyniku Get-PackageUpdateInfo.
PS C:\> Get-PackageUpdateInfo | Show-PackageUpdateReleaseNote -WhatIf
Pokazuje, które moduły zostałyby przetworzone w celu pobrania notatek wydania, bez wykonywania operacji.
Jeśli ten przełącznik jest włączony, zostaniesz poproszony o potwierdzenie przed wykonaniem jakichkolwiek operacji zmieniających 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: ''
Jeden lub więcej obiektów PackageUpdateInfo z Get-PackageUpdateInfo lub Import-PackageUpdateInfo zawierających informacje o notatkach wydania.
Type: Info[]
DefaultValue: ''
SupportsWildcards: false
Aliases:
- Input
ParameterSets:
- Name: ByPackageUpdateInfoObject
Position: 0
IsRequired: false
ValueFromPipeline: true
ValueFromPipelineByPropertyName: true
ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''
Jeden lub więcej obiektów modułu z Get-Module zawierających metadane notatek wydania lub URL notatek wydania.
Type: PSModuleInfo[]
DefaultValue: ''
SupportsWildcards: false
Aliases:
- ModuleName
ParameterSets:
- Name: ByModuleObject
Position: 0
IsRequired: false
ValueFromPipeline: true
ValueFromPipelineByPropertyName: true
ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''
Jeśli ten przełącznik jest włączony, nie zostaną wykonane żadne działania, ale zostaną wyświetlone komunikaty informujące, co by się stało, gdyby polecenie zostało uruchomione.
Type: SwitchParameter
DefaultValue: ''
SupportsWildcards: false
Aliases:
- wi
ParameterSets:
- Name: (All)
Position: Named
IsRequired: false
ValueFromPipeline: false
ValueFromPipelineByPropertyName: false
ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''
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.
Version : 1.1.0.0
Author : Andi Bellstedt
Date : 2026-06-21
Keywords : PackageUpdateInfo, Update, Module, ReleaseNote