To wielostronicowy widok tej sekcji do wydrukowania. Kliknij aby wydrukować.

O tej dokumentacji

1: Przegląd
2: Najlepsze praktyki operacyjne
3: Rozwiązywanie problemów
4: Odwołanie do poleceń modułu

4.1: Add-PackageUpdateRule
4.2: Export-PackageUpdateInfo
4.3: Get-PackageUpdateInfo
4.4: Get-PackageUpdateRule
4.5: Get-PackageUpdateSetting
4.6: Import-PackageUpdateInfo
4.7: Remove-PackageUpdateRule
4.8: Set-PackageUpdateRule
4.9: Set-PackageUpdateSetting
4.10: Show-PackageUpdateReleaseNote

To jest oficjalna strona dokumentacji dla PackageUpdateInfo, modułu PowerShell, który pomaga być na bieżąco z zainstalowanymi modułami, sprawdzając wszystkie lokalnie zainstalowane moduły PowerShell i raportując, które z nich wymagają aktualizacji.

O module

PackageUpdateInfo narodził się z potrzeby z życia: śledzenie aktualizacji modułów w wielu zainstalowanych modułach PowerShell jest nużące i łatwo o zapomnienie. Ten moduł wypełnia tę lukę, automatycznie sprawdzając wszystkie zainstalowane moduły względem PowerShell Gallery i prezentując czytelny przegląd dostępnych aktualizacji.

Kluczowe zasady projektowe:

Wieloplatformowy — obsługuje Windows, Linux i macOS
Kompatybilność między wersjami — obsługuje PowerShell Desktop (5.1+) i Core (7.x)
Konfigurowalny — dostosuj interwały sprawdzania aktualizacji, zasady czułości wersji i wykluczenia
Przyjazny dla potoków — integruje się naturalnie z architekturą potoków PowerShell
Wsparcie powiadomień — opcjonalne powiadomienia desktopowe BurntToast na Windows

Zasoby

GitHub: https://github.com/AndiBellstedt/PackageUpdateInfo
PowerShell Gallery: https://www.powershellgallery.com/packages/PackageUpdateInfo
Blog autora: https://andibellstedt.com

Wkład

Wkład jest mile widziany. Jeśli znajdziesz problemy, błędy lub masz sugestie ulepszeń, proszę otwórz zgłoszenie lub pull request na repozytorium GitHub.

1 - Przegląd

PackageUpdateInfo pomaga Ci utrzymać zainstalowane moduły PowerShell na bieżąco. Porównuje wersje lokalnych modułów z wersjami z skonfigurowanych repozytoriów online (np. PSGallery) i informuje, gdy dostępne są nowsze wersje.

Co robi PackageUpdateInfo?

Moduł może:

Zapytanie o lokalnie zainstalowane moduły.
Wykrywanie aktualnych wersji online.
Porównanie wersji z konfigurowalną czułością (główne, mniejsze, kompilacja, rewizja).
Wyświetlanie szczegółowych wyników, w tym repozytorium, notatek wydania, autora i linków do projektu.
Eksport wyników do późniejszego importu i szybkich procesów uruchamiania.

Dlaczego warto używać PackageUpdateInfo?

Wygoda

Szybko identyfikuj przestarzałe moduły bez ręcznego sprawdzania każdego z nich.
Eksportuj i importuj informacje o aktualizacjach do pracy offline lub z opóźnieniem.
Uruchamiaj sprawdzanie aktualizacji w zadaniach w tle.
Używaj opcjonalnych powiadomień toast na Windows.

Automatyzacja

Harmonogramuj sprawdzanie aktualizacji za pomocą profilu, zaplanowanych zadań lub rutyn uruchamiania.
Wymuszaj interwały sprawdzania aktualizacji, aby ograniczyć niepotrzebne zapytania do repozytoriów.
Ustawiaj własne reguły dotyczące czułości aktualizacji dla poszczególnych modułów.
Wykorzystuj wcześniej wyeksportowane dane do niskolatencyjnego uruchamiania powłoki.

Elastyczność

Uwzględniaj lub pomijaj wzorce nazw modułów.
Definiuj zakres i priorytet reguł z domyślnymi i własnymi ustawieniami.
Działa na Windows, Linux i macOS.
Wspiera Windows PowerShell 5.1 oraz PowerShell 7+.

Wymagania wstępne

Windows PowerShell 5.1 lub PowerShell 7+.
PowerShellGet z dostępem do docelowego repozytorium (np. PSGallery).
Opcjonalnie: moduł BurntToast do powiadomień toast na Windows.

Instalacja

Zainstaluj dla wszystkich użytkowników (wymaga uprawnień administratora):

Install-Module PackageUpdateInfo

Dla bieżącego użytkownika:

Install-Module PackageUpdateInfo -Scope CurrentUser

Szybki start

Uruchom interaktywne sprawdzenie:

Get-PackageUpdateInfo

Wyświetl tylko moduły, które wymagają aktualizacji:

Get-PackageUpdateInfo -ShowOnlyNeededUpdate

Wymuś sprawdzenie, nawet jeśli nie upłynął jeszcze ustawiony interwał:

Get-PackageUpdateInfo -Force

Użyj powiadomień toast (Windows z BurntToast):

Get-PackageUpdateInfo -ShowToastNotification

Praktyczny wzór automatyzacji

Eksportuj dane o aktualizacjach w zadaniu w tle i zaimportuj je przy starcie powłoki:

Start-Job -ScriptBlock { Get-PackageUpdateInfo -ShowOnlyNeededUpdate -ShowToastNotification | Export-PackageUpdateInfo } | Out-Null
Import-PackageUpdateInfo

To zapewnia interaktywne uruchamianie przy starcie, jednocześnie pokazując najnowsze informacje o aktualizacjach.

Kolejne kroki

Kontynuuj z najlepszymi praktykami operacyjnymi dotyczącymi strojenia, projektowania reguł i automatyzacji.
Kontynuuj z rozwiązywaniem problemów, aby radzić sobie z typowymi błędami i procesami odzyskiwania.

2 - Najlepsze praktyki operacyjne

Ta strona opisuje zalecane wzorce operacyjne dla PackageUpdateInfo w interaktywnych powłokach, profilach i automatyzacji.

Zacznij od domyślnego zachowania

Zresetuj ustawienia przed wprowadzeniem własnych dostosowań, szczególnie na systemach współdzielonych:

Set-PackageUpdateSetting -Reset

Sprawdź obecną konfigurację i zasady:

Get-PackageUpdateSetting
Get-PackageUpdateRule -IncludeDefaultRule

Używaj interwałów aktualizacji, aby zmniejszyć hałas

Get-PackageUpdateInfo respektuje UpdateCheckInterval. Jeśli ostatnia skuteczna kontrola mieści się w ustawionym interwale, cmdlet kończy działanie wcześniej.

Ustaw interwał odpowiadający Twojemu środowisku:

Set-PackageUpdateSetting -UpdateCheckInterval (New-TimeSpan -Hours 6)

Używaj -Force tylko do ad-hocowych sprawdzeń:

Get-PackageUpdateInfo -Force

Preferuj nieblokujące uruchomienie powłoki

Praktyczny wzorzec profilu to:

Start-Job -ScriptBlock {
    Get-PackageUpdateInfo -ShowOnlyNeededUpdate | Export-PackageUpdateInfo
} | Out-Null

Import-PackageUpdateInfo

Dlaczego to działa dobrze:

Uruchomienie jest szybkie, ponieważ import odczytuje dane z pamięci podręcznej.
Kosztowna kontrola online działa w tle.
W każdej sesji masz dostęp do przydatnych informacji o aktualizacjach.

Wyraźnie sprawdzaj zakres, gdy jest to potrzebne

Używaj parametrów zakresu, gdy uprawnienia różnią się między modułami użytkownika a systemu:

Get-PackageUpdateInfo -CurrentUser
Get-PackageUpdateInfo -AllUsers

Używaj -Repository w środowiskach z wieloma skonfigurowanymi repozytoriami:

Get-PackageUpdateInfo -Repository PSGallery

Projektuj zasady ostrożnie

Używaj szerokich wykluczeń tylko wtedy, gdy jest to zamierzone. Wykluczanie dużych wzorców może ukryć ważne aktualizacje.

Twórz ukierunkowane, niestandardowe zasady dla modułów o dużej rotacji:

Add-PackageUpdateRule -IncludeModuleForChecking "Az.*" -ReportChangeOnMajor $true -ReportChangeOnMinor $true -ReportChangeOnBuild $false -ReportChangeOnRevision $false

Przejrzyj priorytet zasad, wyświetlając wszystkie:

Get-PackageUpdateRule -IncludeDefaultRule | Sort-Object Id

Używaj eksportu/importu celowo

Domyślne ścieżki eksportu i importu są specyficzne dla platformy i zawierają wersję PowerShell oraz główną wersję w nazwie pliku. To pomaga unikać mieszania danych z różnych środowisk uruchomieniowych.

Typowe opcje eksportu:

Get-PackageUpdateInfo | Export-PackageUpdateInfo -OutputFormat XML
Get-PackageUpdateInfo | Export-PackageUpdateInfo -OutputFormat JSON
Get-PackageUpdateInfo | Export-PackageUpdateInfo -OutputFormat CSV

Zalecenia:

Używaj XML, gdy chcesz zachować obiekty z typami do ponownego importu.
Używaj JSON lub CSV do raportowania zewnętrznego i integracji.
Używaj -IncludeTimeStamp do śledzenia historycznego.

Utrzymuj powiadomienia przydatne

Używaj powiadomień toast tylko tam, gdzie dodają wartość:

Na hostach Windows z zainstalowanym BurntToast.
Na sesjach, gdzie oczekiwane są interaktywne alerty.

Dla serwerów, CI i powłok nieinteraktywnych, preferuj raporty eksportowane zamiast powiadomień toast.

3 - Rozwiązywanie problemów

Skorzystaj z tego przewodnika, gdy PackageUpdateInfo nie zwraca oczekiwanych wyników, pomija kontrole lub nie może zaimportować i wyeksportować danych.

Najpierw uzyskaj konkretne diagnostyki

Uruchom z trybem szczegółowym:

Get-PackageUpdateInfo -Verbose

Zweryfikuj ustawienia i reguły:

Get-PackageUpdateSetting
Get-PackageUpdateRule -IncludeDefaultRule

Sprawdź, czy pominięcie nie jest nieoczekiwane

Objaw:

Widoczny jest ostrzeżenie, że kontrole aktualizacji zostały pominięte, ponieważ czas interwału kontroli nie wygasł.

Przyczyna:

UpdateCheckInterval oraz ostatni LastCheck lub LastSuccessfulCheck uniemożliwiają nową kontrolę online.

Rozwiązanie:

Get-PackageUpdateInfo -Force

Lub skróć interwał:

Set-PackageUpdateSetting -UpdateCheckInterval (New-TimeSpan -Minutes 30)

Brak pliku konfiguracyjnego lub jest uszkodzony

Objaw:

Get-PackageUpdateSetting ostrzega, że plik konfiguracji modułu nie został znaleziony, a następnie rzuca błędem.

Przyczyna:

Ścieżka do pliku konfiguracyjnego nie istnieje lub zawiera nieprawidłowy JSON.

Rozwiązanie:

Set-PackageUpdateSetting -Reset
Get-PackageUpdateSetting

Nie zwraca żadnych modułów

Objaw:

Get-PackageUpdateInfo nic nie zwraca, mimo że moduły są zainstalowane.

Typowe przyczyny:

Reguły uwzględniania i wykluczania filtrują wszystkie moduły.
-CurrentUser lub -AllUsers filtrują moduły, których oczekujesz.
Filtr repozytorium wyklucza odpowiednie moduły.

Kroki rozwiązania:

Get-PackageUpdateRule -IncludeDefaultRule
Get-PackageUpdateInfo -Force
Get-PackageUpdateInfo -CurrentUser -Force
Get-PackageUpdateInfo -AllUsers -Force

Eksport kończy się błędem ścieżki

Objaw:

Eksport zgłasza nieprawidłową ścieżkę lub problem z katalogiem.

Przyczyna:

-Path wskazuje na katalog lub nieistniejące miejsce bez użycia -Force.

Rozwiązanie:

Get-PackageUpdateInfo | Export-PackageUpdateInfo -Path "$HOME\PackageUpdateInfo\updates.xml" -Force

Import nie zwraca danych

Objaw:

Import-PackageUpdateInfo nic nie zwraca.

Typowe przyczyny:

Plik jest pusty lub za mały, by zawierał rekordy.
-InputFormat nie pasuje do wyeksportowanego formatu.
Nieprawidłowa ścieżka pliku dla bieżącego środowiska i wersji.

Rozwiązanie:

Import-PackageUpdateInfo -InputFormat XML -Verbose
Import-PackageUpdateInfo -Path "$HOME\PackageUpdateInfo\updates.json" -InputFormat JSON

Powiadomienia toast nie pojawiają się

Objaw:

Użyto -ShowToastNotification, ale nie pojawia się żadne powiadomienie.

Typowe przyczyny:

BurntToast nie jest zainstalowany.
Platforma hosta nie obsługuje powiadomień toast Windows.
Żaden moduł w wyniku nie ma NeedUpdate = $true.

Rozwiązanie:

Install-Module BurntToast -Scope CurrentUser
Get-PackageUpdateInfo -ShowOnlyNeededUpdate -ShowToastNotification -Force

Nie można dodać lub zmodyfikować reguł

Objaw:

Dodanie reguły kończy się błędem z powodu duplikatu Id, include lub exclude.

Przyczyna:

Istniejące niestandardowe reguły zawierają te same identyfikatory lub wzorce.

Rozwiązanie:

Get-PackageUpdateRule
Add-PackageUpdateRule -IncludeModuleForChecking "MyModule.*"
Set-PackageUpdateRule -Id 1 -ReportChangeOnRevision $false
Remove-PackageUpdateRule -Id 1

Problemy z repozytorium i siecią

Objaw:

Wyszukiwanie wersji online nie powiodło się lub jest niekompletne.

Przyczyny:

Repozytorium nie jest zarejestrowane lub jest niedostępne.
Tymczasowe problemy z siecią.

Rozwiązanie:

Get-PSRepository
Find-Module PackageUpdateInfo -Repository PSGallery
Get-PackageUpdateInfo -Repository PSGallery -Force

Proces odzyskiwania

Jeśli zachowanie nadal jest niekonsekwentne, użyj tej sekwencji resetowania:

Set-PackageUpdateSetting -Reset
Get-PackageUpdateInfo -Force | Export-PackageUpdateInfo
Import-PackageUpdateInfo

4 - Odwołanie do poleceń modułu

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.

4.1 - Add-PackageUpdateRule

SYNOPSIS

Dodaje niestandardową regułę, która kontroluje sposób raportowania aktualizacji modułów.

SYNTAX

__AllParameterSets

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

ALIASES

Ten cmdlet ma następujące aliasy,

DESCRIPTION

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łę.

EXAMPLES

PRZYKŁAD 1

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.

PRZYKŁAD 2

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.

PRZYKŁAD 3

PS C:\> Add-PackageUpdateRule -Id 99 -IncludeModuleForChecking "MyModule" -PassThru

Dodaje regułę z określonym identyfikatorem i zwraca utworzony obiekt reguły.

PRZYKŁAD 4

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.

PARAMETERS

-Confirm

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: ''

-ExcludeModuleFromChecking

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: ''

-Id

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: ''

-IncludeModuleForChecking

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: ''

-PassThru

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: ''

-ReportChangeOnBuild

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: ''

-ReportChangeOnMajor

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: ''

-ReportChangeOnMinor

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: ''

-ReportChangeOnRevision

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: ''

-SettingObject

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: ''

-WhatIf

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: ''

CommonParameters

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.

INPUTS

PackageUpdate.Configuration

OUTPUTS

PackageUpdate.ModuleRule

NOTES

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

packageupdateinfo.andibellstedt.com/docs/commands/add-packageupdaterule

4.2 - Export-PackageUpdateInfo

STRESZCZENIE

Eksportuje obiekty PackageUpdateInfo do pliku XML, JSON lub CSV.

SKŁADNIA

__AllParameterSets

Export-PackageUpdateInfo [[-Path] <string>] -InputObject <Info[]> [-OutputFormat <string>]
 [-Encoding <string>] [-Force] [-Append] [-IncludeTimeStamp] [-PassThru] [-WhatIf] [-Confirm]
 [<CommonParameters>]

ALIASY

Ten cmdlet ma następujące aliasy,

OPIS

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.

PRZYKŁADY

PRZYKŁAD 1

PS C:\> Get-PackageUpdateInfo | Export-PackageUpdateInfo

Eksportuje bieżące obiekty PackageUpdateInfo do domyślnego pliku XML.

PRZYKŁAD 2

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.

PRZYKŁAD 3

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.

PRZYKŁAD 4

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.

PARAMETRY

-Append

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: ''

-Confirm

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: ''

-Encoding

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: ''

-Force

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: ''

-IncludeTimeStamp

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: ''

-InputObject

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: ''

-OutputFormat

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: ''

-PassThru

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: ''

-Path

Ś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: ''

-WhatIf

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: ''

CommonParameters

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.

WEJŚCIA

PackageUpdate.Info[]

WYJŚCIA

PackageUpdate.Info

UWAGI

Wersja : 1.1.0.0 Autor : Andi Bellstedt Data : 2026-06-21 Słowa kluczowe : PackageUpdateInfo, Update, Module, Export

POWIĄZANE LINKI

packageupdateinfo.andibellstedt.com/docs/commands/export-packageupdateinfo

4.3 - Get-PackageUpdateInfo

SYNOPSIS

Pobiera informacje o aktualizacjach dla zainstalowanych modułów PowerShell i identyfikuje moduły, dla których dostępne są nowsze wersje online.

SYNTAX

DefaultSet1 (Domyślny)

Get-PackageUpdateInfo [-Name <string[]>] [-Repository <string[]>] [-ShowOnlyNeededUpdate]
 [-ShowToastNotification] [-Force] [<CommonParameters>]

CurrentUser

Get-PackageUpdateInfo [-Name <string[]>] [-Repository <string[]>] [-ShowOnlyNeededUpdate]
 [-ShowToastNotification] [-CurrentUser] [-Force] [<CommonParameters>]

AllUsers

Get-PackageUpdateInfo [-Name <string[]>] [-Repository <string[]>] [-ShowOnlyNeededUpdate]
 [-ShowToastNotification] [-AllUsers] [-Force] [<CommonParameters>]

ALIASES

Ten cmdlet ma następujące aliasy,

DESCRIPTION

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.

EXAMPLES

PRZYKŁAD 1

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

PRZYKŁAD 2

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

PRZYKŁAD 3

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.

PRZYKŁAD 4

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.

PARAMETERS

-AllUsers

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: ''

-CurrentUser

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: ''

-Force

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: ''

-Name

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: ''

-Repository

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: ''

-ShowOnlyNeededUpdate

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: ''

-ShowToastNotification

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: ''

CommonParameters

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.

INPUTS

System.String[]

OUTPUTS

PackageUpdate.Info

NOTES

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

packageupdateinfo.andibellstedt.com/docs/commands/get-packageupdateinfo

4.4 - Get-PackageUpdateRule

SYNOPSIS

Pobiera jedną lub więcej reguł aktualizacji pakietów używanych do kontrolowania sprawdzania aktualizacji modułów i raportowania.

SYNTAX

ShowAll (Domyślnie)

Get-PackageUpdateRule [-IncludeModuleForChecking <string>] [-ExcludeModuleFromChecking <string>]
 [-IncludeDefaultRule] [-SettingObject <Configuration>] [<CommonParameters>]

ById

Get-PackageUpdateRule -Id <int[]> [-SettingObject <Configuration>] [<CommonParameters>]

ALIASES

Ten cmdlet ma następujące aliasy,

DESCRIPTION

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.

EXAMPLES

PRZYKŁAD 1

PS C:\> Get-PackageUpdateRule

Pobiera wszystkie niestandardowe reguły aktualnie skonfigurowane do obsługi aktualizacji pakietów.

PRZYKŁAD 2

PS C:\> Get-PackageUpdateRule -Id 1, 2

Pobiera niestandardowe reguły o podanych identyfikatorach.

PRZYKŁAD 3

PS C:\> Get-PackageUpdateRule -ExcludeModuleFromChecking 'Pester'

Pobiera niestandardowe reguły, które wykluczają Pester ze sprawdzania aktualizacji.

PRZYKŁAD 4

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ą.

PARAMETERS

-ExcludeModuleFromChecking

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: ''

-Id

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: ''

-IncludeDefaultRule

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: ''

-IncludeModuleForChecking

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: ''

-SettingObject

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: ''

CommonParameters

Ten cmdlet obsługuje parametry wspólne: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction oraz -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

INPUTS

System.Int32[]

PackageUpdate.Configuration

OUTPUTS

PackageUpdate.ModuleRule

NOTES

Wersja : 1.1.0.0 Autor : Andi Bellstedt Data : 2026-06-21 Słowa kluczowe : PackageUpdateInfo, Aktualizacja, Moduł, Reguła

packageupdateinfo.andibellstedt.com/docs/commands/get-packageupdaterule

4.5 - Get-PackageUpdateSetting

SYNOPSIS

Pobiera konfigurację PackageUpdateInfo z pliku ustawień modułu.

SYNTAX

__AllParameterSets

Get-PackageUpdateSetting [[-Path] <string>] [<CommonParameters>]

ALIASES

Ten cmdlet ma następujące aliasy,

DESCRIPTION

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ń.

EXAMPLES

PRZYKŁAD 1

PS C:\> Get-PackageUpdateSetting

Pobiera bieżące ustawienia PackageUpdateInfo z domyślnego pliku konfiguracyjnego.

PRZYKŁAD 2

PS C:\> Get-PackageUpdateSetting -Path "C:\temp\PackageUpdateInfo.json"

Odczytuje konfigurację PackageUpdateInfo z określonego pliku ustawień.

PRZYKŁAD 3

PS C:\> Get-PackageUpdateSetting | Select-Object -ExpandProperty UpdateCheckInterval

Zwraca skonfigurowany interwał sprawdzania aktualizacji z bieżących ustawień.

PARAMETERS

-Path

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: ''

CommonParameters

OUTPUTS

PackageUpdate.Configuration

NOTES

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

packageupdateinfo.andibellstedt.com/docs/commands/get-packageupdatesetting

4.6 - Import-PackageUpdateInfo

SYNOPSIS

Importuje informacje o aktualizacjach pakietów z wcześniej wyeksportowanego pliku danych.

SYNTAX

__AllParameterSets

Import-PackageUpdateInfo [[-Path] <string>] [-ShowToastNotification] [-InputFormat <string>]
 [-Encoding <string>] [-WhatIf] [-Confirm] [<CommonParameters>]

ALIASES

Ten cmdlet ma następujące aliasy,

DESCRIPTION

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.

EXAMPLES

PRZYKŁAD 1

PS C:\> Import-PackageUpdateInfo

Importuje domyślny plik informacji o aktualizacjach pakietów dla bieżącego środowiska PowerShell.

PRZYKŁAD 2

PS C:\> Import-PackageUpdateInfo -Path C:\temp\packageupdateinfo.xml

Importuje informacje o aktualizacjach z określonego pliku XML.

PRZYKŁAD 3

PS C:\> Import-PackageUpdateInfo -Path .\updates.json -InputFormat JSON

Importuje informacje o aktualizacjach z pliku JSON, używając określonego formatu wejściowego.

PRZYKŁAD 4

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.

PARAMETERS

-Confirm

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: ''

-Encoding

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: ''

-InputFormat

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: ''

-Path

Ś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: ''

-ShowToastNotification

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: ''

-WhatIf

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: ''

CommonParameters

INPUTS

System.String

OUTPUTS

PackageUpdate.Info

NOTES

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

packageupdateinfo.andibellstedt.com/docs/commands/import-packageupdateinfo

4.7 - Remove-PackageUpdateRule

SYNOPSIS

Usuwa jedną lub więcej niestandardowych reguł obsługi aktualizacji z konfiguracji aktualizacji pakietu.

SYNTAX

ById (Domyślnie)

Remove-PackageUpdateRule -Id <int[]> [-Force] [-PassThru] [-SettingObject <Configuration>] [-WhatIf]
 [-Confirm] [<CommonParameters>]

ByInputObject

Remove-PackageUpdateRule -InputObject <ModuleRule[]> [-Force] [-PassThru]
 [-SettingObject <Configuration>] [-WhatIf] [-Confirm] [<CommonParameters>]

ALIASES

Ten cmdlet ma następujące aliasy,

DESCRIPTION

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.

EXAMPLES

PRZYKŁAD 1

PS C:\> Get-PackageUpdateRule | Remove-PackageUpdateRule

Usuwa wszystkie niestandardowe reguły aktualizacji z bieżących ustawień modułu.

PRZYKŁAD 2

PS C:\> Remove-PackageUpdateRule -Id 12

Usuwa niestandardową regułę o identyfikatorze 12 z bieżącej konfiguracji.

PRZYKŁAD 3

$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.

PRZYKŁAD 4

$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.

PARAMETERS

-Confirm

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: ''

-Force

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: ''

-Id

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: ''

-InputObject

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: ''

-PassThru

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: ''

-SettingObject

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: ''

-WhatIf

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: ''

CommonParameters

Ten cmdlet obsługuje wspólne parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction oraz -WarningVariable. Więcej informacji znajdziesz w about_CommonParameters.

INPUTS

System.Int32[]

PackageUpdate.ModuleRule[]

PackageUpdate.Configuration

OUTPUTS

PackageUpdate.ModuleRule

NOTES

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

packageupdateinfo.andibellstedt.com/docs/commands/remove-packageupdaterule

4.8 - Set-PackageUpdateRule

SYNOPSIS

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

SYNTAX

ById (Domyślnie)

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

ByInputObject

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

ALIASES

Ten cmdlet ma następujące aliasy,

DESCRIPTION

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

EXAMPLES

PRZYKŁAD 1

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

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

PRZYKŁAD 2

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

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

PRZYKŁAD 3

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

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

PRZYKŁAD 4

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

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

PARAMETERS

-Confirm

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

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

-ExcludeModuleFromChecking

Jedna lub więcej nazw modułów, które mają być wyłączone z kontroli aktualizacji dla zmienianej reguły.

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

-Id

Numeryczny identyfikator reguły do modyfikacji.

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

-IncludeModuleForChecking

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

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

-InputObject

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

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

-PassThru

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

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

-ReportChangeOnBuild

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

Raportuj, gdy zmieni się wersja build modułu

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

Major Minor Build Revision

0 0 1 0

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

-ReportChangeOnMajor

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

Raportuj, gdy zmieni się wersja major modułu

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

Major Minor Build Revision

1 0 0 0

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

-ReportChangeOnMinor

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

Raportuj, gdy zmieni się wersja minor modułu

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

Major Minor Build Revision

0 1 0 0

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

-ReportChangeOnRevision

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

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

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

Major Minor Build Revision

0 0 0 1

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

-SettingObject

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

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

-WhatIf

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

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

CommonParameters

Ten cmdlet obsługuje wspólne parametry: -Debug, -ErrorAction, -ErrorVariable,
-InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable,
-ProgressAction, -Verbose, -WarningAction oraz -WarningVariable. Więcej informacji znajdziesz w
about_CommonParameters.

INPUTS

System.Int32

PackageUpdate.ModuleRule[]

PackageUpdate.Configuration

OUTPUTS

PackageUpdate.ModuleRule

NOTES

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

packageupdateinfo.andibellstedt.com/docs/commands/set-packageupdaterule

4.9 - Set-PackageUpdateSetting

SYNOPSIS

Konfiguruje zachowanie sprawdzania aktualizacji oraz preferencje raportowania dla PackageUpdateInfo.

SYNTAX

SetBehaviour

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

ResetBehaviour

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

ALIASES

Ten cmdlet ma następujące aliasy,

DESCRIPTION

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

EXAMPLES

PRZYKŁAD 1

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

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

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

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

PRZYKŁAD 2

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

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

PRZYKŁAD 3

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

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

PRZYKŁAD 4

PS C:\> Set-PackageUpdateSetting -Reset

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

PRZYKŁAD 5

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

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

PARAMETERS

-Confirm

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

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

-ExcludeModuleFromChecking

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

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

-IncludeModuleForChecking

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

Wartość domyślna to: “*”

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

-InputObject

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

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

-LastCheck

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

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

-LastSuccessfulCheck

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

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

-PassThru

Zwraca zaktualizowany obiekt ustawień do potoku do dalszego przetwarzania.

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

-Path

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

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

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

-ReportChangeOnBuild

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

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

Major Minor Build Revision

0 0 1 0

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

-ReportChangeOnMajor

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

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

Major Minor Build Revision

1 0 0 0

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

-ReportChangeOnMinor

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

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

Major Minor Build Revision

0 1 0 0

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

-ReportChangeOnRevision

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

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

Major Minor Build Revision

1 0 0 0

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

-Reset

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

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

-UpdateCheckInterval

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

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

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

-WhatIf

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

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

CommonParameters

Ten cmdlet obsługuje parametry wspólne: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction oraz -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

INPUTS

PackageUpdate.Configuration

OUTPUTS

PackageUpdate.Configuration

NOTES

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

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

4.10 - Show-PackageUpdateReleaseNote

SYNOPSIS

Wyświetla notatki wydania dla jednego lub więcej modułów PowerShell.

SYNTAX

ByPackageUpdateInfoObject

Show-PackageUpdateReleaseNote [[-InputObject] <Info[]>] [-WhatIf] [-Confirm] [<CommonParameters>]

ByModuleObject

Show-PackageUpdateReleaseNote [[-Module] <psmoduleinfo[]>] [-WhatIf] [-Confirm] [<CommonParameters>]

ALIASES

Ten cmdlet ma następujące aliasy,

DESCRIPTION

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.

EXAMPLES

PRZYKŁAD 1

PS C:\> Get-PackageUpdateInfo | Show-PackageUpdateReleaseNote

Pobiera notatki wydania dla każdego modułu zwróconego przez Get-PackageUpdateInfo.

PRZYKŁAD 2

PS C:\> Get-Module PackageUpdateInfo | Show-PackageUpdateReleaseNote

Pobiera notatki wydania dla modułu PackageUpdateInfo z bieżącej sesji PowerShell.

PRZYKŁAD 3

PS C:\> Get-PackageUpdateInfo -Name PackageUpdateInfo | Show-PackageUpdateReleaseNote

Wyświetla notatki wydania dla konkretnego modułu, korzystając z wyniku Get-PackageUpdateInfo.

PRZYKŁAD 4

PS C:\> Get-PackageUpdateInfo | Show-PackageUpdateReleaseNote -WhatIf

Pokazuje, które moduły zostałyby przetworzone w celu pobrania notatek wydania, bez wykonywania operacji.

PARAMETERS

-Confirm

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: ''

-InputObject

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: ''

-Module

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: ''

-WhatIf

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: ''

CommonParameters

Ten cmdlet obsługuje wspólne parametry: -Debug, -ErrorAction, -ErrorVariable,
-InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable,
-ProgressAction, -Verbose, -WarningAction oraz -WarningVariable. Więcej informacji znajdziesz w
about_CommonParameters.

INPUTS

PackageUpdate.Info[]

System.Management.Automation.PSModuleInfo[]

OUTPUTS

PackageUpdate.ReleaseNote

NOTES

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

packageupdateinfo.andibellstedt.com/docs/commands/show-packageupdatereleasenote

O tej dokumentacji

O module

Zasoby

Wkład

1 - Przegląd

Co robi PackageUpdateInfo?

Dlaczego warto używać PackageUpdateInfo?

Wygoda

Automatyzacja

Elastyczność

Wymagania wstępne

Instalacja

Szybki start

Praktyczny wzór automatyzacji

Kolejne kroki

2 - Najlepsze praktyki operacyjne

Zacznij od domyślnego zachowania

Używaj interwałów aktualizacji, aby zmniejszyć hałas

Preferuj nieblokujące uruchomienie powłoki

Wyraźnie sprawdzaj zakres, gdy jest to potrzebne

Projektuj zasady ostrożnie

Używaj eksportu/importu celowo

Utrzymuj powiadomienia przydatne

3 - Rozwiązywanie problemów

Najpierw uzyskaj konkretne diagnostyki

Sprawdź, czy pominięcie nie jest nieoczekiwane

Brak pliku konfiguracyjnego lub jest uszkodzony

Nie zwraca żadnych modułów

Eksport kończy się błędem ścieżki

Import nie zwraca danych

Powiadomienia toast nie pojawiają się

Nie można dodać lub zmodyfikować reguł

Problemy z repozytorium i siecią

Proces odzyskiwania

4 - Odwołanie do poleceń modułu

4.1 - Add-PackageUpdateRule

SYNOPSIS

SYNTAX

__AllParameterSets

ALIASES

DESCRIPTION

EXAMPLES

PRZYKŁAD 1

PRZYKŁAD 2

PRZYKŁAD 3

PRZYKŁAD 4

PARAMETERS

-Confirm

-ExcludeModuleFromChecking

-Id

-IncludeModuleForChecking

-PassThru

-ReportChangeOnBuild

-ReportChangeOnMajor

-ReportChangeOnMinor

-ReportChangeOnRevision

-SettingObject

-WhatIf

CommonParameters

INPUTS

PackageUpdate.Configuration

OUTPUTS

PackageUpdate.ModuleRule

NOTES

RELATED LINKS

4.2 - Export-PackageUpdateInfo

STRESZCZENIE

SKŁADNIA

__AllParameterSets

ALIASY

OPIS

PRZYKŁADY

PRZYKŁAD 1

PRZYKŁAD 2

PRZYKŁAD 3

PRZYKŁAD 4

PARAMETRY

-Append

-Confirm

-Encoding