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]
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 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łę.
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.
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.
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życia 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ć 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: ''
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 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: ''
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: ''
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: ''
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: ''
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: ''
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 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
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]
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 również tworzenie katalogu docelowego 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 katalog docelowy, 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 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 pliku docelowego, 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: ''
Wysyła wyeksportowane obiekty do 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 pliku docelowego dla eksportowanych danych. Należy podać ś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 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 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, Export
Pobierz informacje o aktualizacjach zainstalowanych modułów PowerShell i zidentyfikuj moduły, dla których dostępne są nowsze wersje online.
Get-PackageUpdateInfo [-Name <string[]>] [-Repository <string[]>] [-ShowOnlyNeededUpdate]
[-ShowToastNotification] [-Force]
Get-PackageUpdateInfo [-Name <string[]>] [-Repository <string[]>] [-ShowOnlyNeededUpdate]
[-ShowToastNotification] [-CurrentUser] [-Force]
Get-PackageUpdateInfo [-Name <string[]>] [-Repository <string[]>] [-ShowOnlyNeededUpdate]
[-ShowToastNotification] [-AllUsers] [-Force]
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 wymusisz natychmiastowe 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, co ułatwia skupienie się na modułach wymagających 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 w 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 powinno być Twoim domyślnym sposobem 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 natychmiastowe, ś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 zostanie pominięty, funkcja użyje skonfigurowanych reguł dołączania, aby określić, które moduły powinny zostać sprawdzone.
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żyje 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, jeśli 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 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.2.0.0 Author : Andi Bellstedt Date : 2026-06-21 Keywords : PackageUpdateInfo, Update, Module
Pobierz 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>]
Get-PackageUpdateRule -Id <int[]> [-SettingObject <Configuration>]
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
Pobierz wszystkie niestandardowe reguły aktualnie skonfigurowane do obsługi aktualizacji pakietów.
PS C:\> Get-PackageUpdateRule -Id 1, 2
Pobierz niestandardowe reguły o podanych identyfikatorach.
PS C:\> Get-PackageUpdateRule -ExcludeModuleFromChecking 'Pester'
Pobierz niestandardowe reguły, które wykluczają Pester ze sprawdzania aktualizacji.
PS C:\> Get-PackageUpdateRule -IncludeModuleForChecking 'PackageManagement' -IncludeDefaultRule
Pobierz niestandardowe reguły, które uwzględniają PackageManagement do sprawdzania aktualizacji oraz zwróć domyślną regułę.
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 domyślną regułę z podanego lub aktywnego obiektu ustawień do wyniku oprócz dowolnych 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ędnione, jeśli nie podano filtru.
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. Więcej informacji znajdziesz w 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>]
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 ostatniego i ostatniego pomyślnego sprawdzenia.
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ń, który ma zostać odczytany.
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. 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ł, Ustawienie
Importuje informacje o aktualizacjach pakietów z wcześniej wyeksportowanego pliku danych.
Import-PackageUpdateInfo [[-Path] <string>] [-ShowToastNotification] [-InputFormat <string>]
[-Encoding <string>] [-WhatIf] [-Confirm]
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, 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: ''
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 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. Więcej informacji znajdziesz w about_CommonParameters.
Wersja : 1.1.0.0 Autor : Andi Bellstedt Data : 2026-06-21 Słowa kluczowe : PackageUpdateInfo, Aktualizacja, Moduł, Informacje
Usuwa jedną lub więcej niestandardowych reguł obsługi aktualizacji z konfiguracji aktualizacji pakietów.
Remove-PackageUpdateRule -Id <int[]> [-Force] [-PassThru] [-SettingObject <Configuration>] [-WhatIf]
[-Confirm]
Remove-PackageUpdateRule -InputObject <ModuleRule[]> [-Force] [-PassThru]
[-SettingObject <Configuration>] [-WhatIf] [-Confirm]
Ten cmdlet ma następujące aliasy,
Usuwa istniejące niestandardowe reguły definiujące, jak konkretne 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 potwierdzenia i zapisuje zaktualizowane ustawienia na dysk.
Jeśli ten przełącznik jest włączony, zostaniesz poproszony o potwierdzenie przed wykonaniem 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. Aby uzyskać więcej informacji, zobacz 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]
Set-PackageUpdateRule -InputObject <ModuleRule[]> [-IncludeModuleForChecking <string[]>]
[-ExcludeModuleFromChecking <string[]>] [-ReportChangeOnMajor <bool>] [-ReportChangeOnMinor <bool>]
[-ReportChangeOnBuild <bool>] [-ReportChangeOnRevision <bool>] [-SettingObject <Configuration>]
[-PassThru] [-WhatIf] [-Confirm]
Ten cmdlet ma następujące aliasy,
Ten cmdlet modyfikuje istniejącą regułę aktualizacji zapisaną w konfiguracji PackageUpdateInfo, tak aby kontrole aktualizacji mogły być zawężone lub rozszerzone dla konkretnych modułów. Możesz go użyć, aby dołączać lub wykluczać 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łą zidentyfikowaną 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, aby MyModule był oceniany wyraźnie, a raportowane były tylko zmiany główne, poboczne 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, zachowując regułę 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 listę uwzględnionych modułów i aktualizuje regułę tak, aby tylko zmiany główne i rewizji 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 głównej powoduje, że reguła zgłasza potrzebę aktualizacji.
Raportuj, gdy zmieni się wersja główna modułu
Oznacza to, że ‘Get-PackageUpdateSetting’ zgłasza potrzebę aktualizacji, tylko gdy zmieni się wersja główna 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 pobocznej powoduje, że reguła zgłasza potrzebę aktualizacji.
Raportuj, gdy zmieni się wersja poboczna modułu
Oznacza to, że ‘Get-PackageUpdateSetting’ zgłasza potrzebę aktualizacji, tylko gdy zmieni się wersja poboczna 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 rewizji powoduje, że reguła zgłasza potrzebę aktualizacji.
Raportuj, gdy zmieni się część rewizji modułu
Oznacza to, że ‘Get-PackageUpdateSetting’ zgłasza potrzebę aktualizacji, tylko gdy zmieni się wersja rewizji 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 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
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]
Set-PackageUpdateSetting [-Reset] [-Path <string>] [-PassThru] [-WhatIf] [-Confirm]
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 aktualizacji, definiować, jak często wykonywane są 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 uniknięcie 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 przy każdym uruchomieniu powłoki.
Opis tego sposobu znajduje się w sekcji ‘practical-usage’ na stronie projektu GitHub:
https://github.com/AndiBellstedt/PackageUpdateInfo#practical-usage
PS C:\> Set-PackageUpdateSetting -ExcludeModuleFromChecking "Az.*"
Dodaje wszystkie moduły zaczynające się od Az. do listy wykluczonych z kontroli aktualizacji.
Jest to uważane za złą praktykę, ponieważ nie otrzymasz żadnych informacji o aktualizacjach dla wszystkich modułów Az.
(a te 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 przy każdym uruchomieniu powłoki.
Opis tego sposobu znajduje się w sekcji ‘practical-usage’ na stronie projektu 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 ustawiony interwał sprawdzania na jedną godzinę.
PS C:\> Set-PackageUpdateSetting -Reset
Resetuje ustawienia aktualizacji pakietów do 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.
Prosi o potwierdzenie przed wykonaniem 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 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 revision 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 revision 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. Więcej informacji znajdziesz w
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]
Show-PackageUpdateReleaseNote [[-Module] <psmoduleinfo[]>] [-WhatIf] [-Confirm]
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 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 są wykonywane żadne działania, ale wyświetlane są 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. Aby uzyskać więcej informacji, zobacz about_CommonParameters.
Wersja : 1.1.0.0 Autor : Andi Bellstedt Data : 2026-06-21 Słowa kluczowe : PackageUpdateInfo, Update, Module, ReleaseNote