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: Show-PackageUpdateReleaseNote
4.10: Ustaw-PodstawoweUstawieniaAktualizacjiPakietu

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 regułę do sprawdzania i raportowania zainstalowanych 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 pozwala zadeklarować, jak moduły są obsługiwane w specjalnym raportowaniu.

Na przykład możesz skonfigurować PackageUpdateInfo tak, aby tłumić aktualizacje rewizji w często aktualizowanym module, tak aby tylko aktualizacje build, minor lub major były raportowane jako „wymagana aktualizacja”.

EXAMPLES

PRZYKŁAD 1

PS C:\> Add-PackageUpdateRule -IncludeModuleForChecking "MyModule" -ReportChangeOnMajor $true -ReportChangeOnMinor $true -ReportChangeOnBuild $true -ReportChangeOnRevision $false

Dodaje nową niestandardową regułę dla „MyModule”, aby tłumić powiadomienia o aktualizacjach rewizji modułu

PARAMETERS

-Confirm

Jeśli ten przełącznik jest włączony, przed wykonaniem 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: ''

-ExcludeModuleFromChecking

Nazwy modułów do wykluczenia ze sprawdzania aktualizacji

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

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

Nazwy modułów do uwzględnienia w sprawdzaniu aktualizacji Domyślnie uwzględnione są wszystkie moduły.

Wartość domyślna to: “*”

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

Obiekt reguły zostanie przekazany 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: ''

-ReportChangeOnBuild

Raportuj, gdy zmieni się wersja build modułu

Oznacza to, że ‘Get-PackageUpdateSetting’ zgłosi potrzebę aktualizacji, 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

Raportuj, gdy zmieni się wersja major modułu

Oznacza to, że ‘Get-PackageUpdateSetting’ zgłosi potrzebę aktualizacji, tylko 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

Raportuj, gdy zmieni się wersja minor modułu

Oznacza to, że ‘Get-PackageUpdateSetting’ zgłosi potrzebę aktualizacji, tylko 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

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

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

Major Minor Build Revision

0 0 0 1

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ń przekazywany z polecenia Get-PackageUpdateSetting To parametr opcjonalny. Domyślnie używa domyślnego obiektu ustawień z 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

Jeśli ten przełącznik jest włączony, nie zostaną wykonane żadne działania, ale zostaną wyświetlone komunikaty informacyjne wyjaśniają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. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

INPUTS

PackageUpdate.Configuration

OUTPUTS

PackageUpdate.ModuleRule

4.2 - Export-PackageUpdateInfo

SYNOPSIS

Eksportuje PackageUpdateInfo do pliku danych

SYNTAX

__AllParameterSets

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

ALIASES

Ten cmdlet ma następujące aliasy,

DESCRIPTION

Eksportuje PackageUpdateInfo do pliku danych

EXAMPLES

PRZYKŁAD 1

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

Przykład użycia Export-PackageUpdateInfo

PARAMETERS

-Append

Plik wyjściowy nie zostanie zastąpiony. Wszystkie informacje zostaną dopisane.

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, przed wykonaniem 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

Kodowanie pliku

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

Jeśli katalog dla pliku nie istnieje, ale określono inny niż domyślny katalog, funkcja spróbuje utworzyć ten katalog.

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

Do rekordów informacji zostanie dodany znacznik czasu.

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

PackageUpdateInfo z funkcji Get-PackageUpdateInfo.

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 dla danych. Dostępne formaty to “XML”, “JSON”, “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

Eksportowane obiekty zostaną przekazane 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

Ścieżka pliku, do którego mają zostać wyeksportowane informacje. Proszę podać plik jako ścieżkę.

Domyślna wartość ścieżki to: Linux: “$HOME/.local/share/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 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. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

INPUTS

PackageUpdate.Info[]

OUTPUTS

PackageUpdate.Info

4.3 - Get-PackageUpdateInfo

SYNOPSIS

Pobierz informacje o aktualności zainstalowanych modułów

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 pobiera informacje o lokalnie zainstalowanych modułach i porównuje je z wersjami online pod kątem aktualności

EXAMPLES

PRZYKŁAD 1

PS C:\> Get-PackageUpdateInfo

Wyświetla informacje o aktualizacjach dla wszystkich modułów (CurrentUser i AllUsers). 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

To przefiltruje wyjście, pokazując tylko moduły, dla których 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

Obsługuje potok. Zwraca informacje tylko dla dwóch modułów: “Pester” i “PSReadline”.

Można to też zrobić za pomocą cmdletu Get-Module: Get-Module “Pester”, “PSReadline” | Get-PackageUpdateInfo

PARAMETERS

-AllUsers

Szukaj modułów tylko w katalogach AllUsers/system. Pamiętaj, że do aktualizacji tych modułów wymagane są prawa 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

Szukaj modułów tylko w profilu bieżącego użytkownika. Jest to przydatne, jeśli uruchamiasz bez praw 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: ''

-Force

Wymuś pobranie informacji o aktualności zainstalowanych modułów, nawet jeśli interwał UpdateCheckInterval od ostatniego sprawdzenia nie wygasł.

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

Nazwa modułu do sprawdzenia.

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

-Repository

Repozytorium do sprawdzenia.

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

-ShowOnlyNeededUpdate

Ten przełącznik powoduje, że w wyjściu nie będą pokazywane moduły aktualne.

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

Ten przełącznik wywołuje ładne powiadomienia Windows Toast z informacjami o wersji dla modułów, które wymagają 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: ''

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

System.String[]

OUTPUTS

PackageUpdate.Info

4.4 - Get-PackageUpdateRule

SYNOPSIS

Pobierz regułę/reguły do sprawdzania i raportowania zainstalowanych modułów

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

To polecenie pobiera istniejące niestandardowe reguły dotyczące sposobu obsługi modułów w raportowaniu.

EXAMPLES

PRZYKŁAD 1

PS C:\> Get-PackageUpdateRule

Pobierz wszystkie istniejące niestandardowe reguły

PRZYKŁAD 2

PS C:\> Get-PackageUpdateRule -Id 1

Pobierz niestandardową regułę o Id 1

PARAMETERS

-ExcludeModuleFromChecking

Nazwy modułów do wykluczenia 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

Id jako identyfikator reguły

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

-IncludeDefaultRule

Wyświetla DefaultRule z obiektu ustawień, oprócz 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

Nazwy modułów do uwzględnienia w sprawdzaniu aktualizacji Domyślnie uwzględnione są wszystkie moduły.

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

Obiekt ustawień przekazany z polecenia Get-PackageUpdateSetting Jest to parametr opcjonalny. Domyślnie używa domyślnego obiektu ustawień z 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

INPUTS

System.Int32[]

PackageUpdate.Configuration

OUTPUTS

PackageUpdate.ModuleRule

4.5 - Get-PackageUpdateSetting

SYNOPSIS

Ustawienia zachowania modułu PackageUpdateInfo

SYNTAX

__AllParameterSets

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

ALIASES

Ten cmdlet ma następujące aliasy,

DESCRIPTION

Pobiera podstawowe ustawienia dotyczące sprawdzania i raportowania informacji o aktualności zainstalowanych modułów

EXAMPLES

PRZYKŁAD 1

PS C:\> Get-PackageUpdateSetting

Pobiera bieżące ustawienia zachowania modułu PackageUpdateInfo.

PARAMETERS

-Path

Ścieżka do pliku ustawień

Opcjonalne, domyślna ścieżka to: Linux: “$HOME/.local/share/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

4.6 - Import-PackageUpdateInfo

SYNOPSIS

Importuje PackageUpdateInfo z 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 PackageUpdateInfo z pliku danych wcześniej wyeksportowanego za pomocą funkcji Export-PackageUpdateInfo.

EXAMPLES

PRZYKŁAD 1

PS C:\> Import-PackageUpdateInfo

Próba importu domyślnego pliku “$HOME\AppData\Local\Microsoft\Windows\PowerShell\PackageUpdateInfo_$($PSEdition)_$($PSVersionTable.PSVersion.Major).xml”

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

-Encoding

Kodowanie pliku

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

Format wyjściowy danych
Dostępne formaty to “XML”, “JSON”, “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 pliku, z którego importowane są informacje.
Proszę podać plik jako ścieżkę.

Domyślna wartość ścieżki to:
Linux: “$HOME/.local/share/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

Ten przełącznik wywołuje estetyczne powiadomienia Windows Toast 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: ''

-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. Aby uzyskać więcej informacji, zobacz
about_CommonParameters.

INPUTS

System.String

OUTPUTS

PackageUpdate.Info

4.7 - Remove-PackageUpdateRule

SYNOPSIS

usuń regułę(-y) do sprawdzania i raportowania zainstalowanych modułów

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

To polecenie usuwa istniejące niestandardowe reguły dotyczące sposobu obsługi modułów w raportowaniu.

EXAMPLES

PRZYKŁAD 1

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

Usuń wszystkie niestandardowe reguły dotyczące obsługi aktualizacji modułów.

PARAMETERS

-Confirm

Jeśli ten przełącznik jest włączony, przed wykonaniem 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: ''

-Force

Jeśli zostanie określony, użytkownik nie zostanie poproszony o potwierdzenie.

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

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

-InputObject

Obiekt reguły przekazywany z polecenia Get-PackageUpdateRule
To jest parametr obowiązkowy w tym zestawie parametrów

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

-PassThru

Obiekt reguły zostanie przekazany 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 ustawień z polecenia Get-PackageUpdateSetting
To jest parametr opcjonalny.
Domyślnie używa domyślnego obiektu ustawień z 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: ''

-WhatIf

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

System.Int32[]

PackageUpdate.ModuleRule[]

PackageUpdate.Configuration

OUTPUTS

PackageUpdate.ModuleRule

4.8 - Set-PackageUpdateRule

SYNOPSIS

Ustaw regułę sprawdzania i raportowania zainstalowanych modułów

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

To polecenie pozwala edytować istniejące reguły dotyczące sposobu obsługi modułów w raportowaniu.

Na przykład możesz skonfigurować PackageUpdateInfo tak, aby tłumić aktualizacje rewizji często aktualizowanego modułu, tak aby tylko aktualizacje build, minor lub major były raportowane jako „wymagana aktualizacja”.

EXAMPLES

PRZYKŁAD 1

PS C:\> Add-PackageUpdateRule -IncludeModuleForChecking "MyModule" -ReportChangeOnMajor $true -ReportChangeOnMinor $true -ReportChangeOnBuild $true -ReportChangeOnRevision $false

Dodaj nową niestandardową regułę dla „MyModule”, aby tłumić powiadomienia o aktualizacjach rewizji modułu

PARAMETERS

-Confirm

Jeśli ten przełącznik jest włączony, przed wykonaniem 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: ''

-ExcludeModuleFromChecking

Nazwy modułów do wykluczenia ze sprawdzania aktualizacji

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

Identyfikator reguły

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

Nazwy modułów do uwzględnienia w sprawdzaniu aktualizacji Domyślnie uwzględnione są wszystkie moduły.

Wartość domyślna to: “*”

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 modyfikacji

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

-PassThru

Obiekt reguły zostanie przekazany 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: ''

-ReportChangeOnBuild

Raportuj, gdy zmieni się wersja build modułu

Oznacza to, że ‘Get-PackageUpdateSetting’ zgłosi potrzebę aktualizacji, 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

Raportuj, gdy zmieni się wersja major modułu

Oznacza to, że ‘Get-PackageUpdateSetting’ zgłosi potrzebę aktualizacji tylko wtedy, 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

Raportuj, gdy zmieni się wersja minor modułu

Oznacza to, że ‘Get-PackageUpdateSetting’ zgłosi potrzebę aktualizacji tylko wtedy, 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

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

Oznacza to, że ‘Get-PackageUpdateSetting’ zgłosi potrzebę aktualizacji, 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: ''

-SettingObject

Obiekt ustawień przekazany z polecenia Get-PackageUpdateSetting Jest to parametr opcjonalny. Domyślnie używa domyślnego obiektu ustawień z 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: ''

-WhatIf

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

PackageUpdate.ModuleRule[]

PackageUpdate.Configuration

OUTPUTS

PackageUpdate.ModuleRule

4.9 - Show-PackageUpdateReleaseNote

SYNOPSIS

Wyświetla notatki wydania z modułu

SKŁADNIA

ByPackageUpdeInfoObject

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

ByModuleObject

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

ALIASY

Ten cmdlet ma następujące aliasy,

OPIS

Wyświetla notatki wydania z modułu.

PRZYKŁADY

PRZYKŁAD 1

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

Pobiera notatki wydania z obiektów PackageUpdateInfo

PRZYKŁAD 2

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

Pobiera notatki wydania z modułu

PARAMETRY

-Confirm

Jeśli ta opcja jest włączona, 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: ''

-InputObject

Obiekt(y) wejściowe z Get-PackageUpdateInfo lub Import-PackageUpdateInfo do wyświetlenia notatek wydania

Type: Info[]
DefaultValue: ''
SupportsWildcards: false
Aliases:
- Input
ParameterSets:
- Name: ByPackageUpdeInfoObject
  Position: 0
  IsRequired: false
  ValueFromPipeline: true
  ValueFromPipelineByPropertyName: true
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Module

Obiekt(y) wejściowe z Get-Module do wyświetlenia 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 ta opcja jest włączona, nie będą wykonywane żadne akcje, ale wyświetlane będą komunikaty informacyjne wyjaśniające, co się stałoby, 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 i -WarningVariable. Więcej informacji znajdziesz w about_CommonParameters.

INPUTS

PackageUpdate.Info[]

System.Management.Automation.PSModuleInfo[]

OUTPUTS

PackageUpdate.ReleaseNote

4.10 - Ustaw-PodstawoweUstawieniaAktualizacjiPakietu

SYNOPSIS

Ustawienia zachowania dla modułu PackageUpdateInfo

SYNTAXA

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>]

ALIASY

Ten cmdlet ma następujące aliasy,

OPIS

Set-PackageUpdateInfo konfiguruje podstawowe ustawienia dla sprawdzania i raportowania informacji o aktualności zainstalowanych modułów

PRZYKŁADY

PRZYKŁAD 1

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

Resetuje moduł do domyślnego zachowania

PRZYKŁAD 2

PS C:\> Set-PackageUpdateSetting -Reset

Resetuje moduł do domyślnego zachowania

PARAMETRY

-Confirm

Jeśli ta opcja jest włączona, przed wykonaniem operacji zmieniającej 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: ''

-ExcludeModuleFromChecking

Nazwy modułów do wykluczenia z sprawdzania aktualizacji w domyślnej regule

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 do uwzględnienia w sprawdzaniu aktualizacji w domyślnej regule Domyślnie wszystkie moduły są uwzględnione.

Domyślna wartość 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 ustawień parsowany z polecenia Get-PackageUpdateSetting

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 ostatnio sprawdzano aktualizacje dla 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 ostatnie sprawdzenie aktualizacji zostało zakończone

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

-PassThru

Obiekt ustawień zostanie przekazany 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

Ścieżka do pliku ustawień

Opcjonalne, domyślna ścieżka to: Linux: “$HOME/.local/share/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

Zgłasza zmianę wersji kompilacji dla modułu w domyślnej regule

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

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

Zgłasza zmianę wersji głównej dla modułu w domyślnej regule

Oznacza, że ‘Get-PackageUpdateSetting’ zgłasza potrzebę aktualizacji, tylko gdy wersja główna modułu się zmienia.

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

Zgłasza zmianę wersji minor dla modułu w domyślnej regule

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

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

Zgłasza zmianę wersji rewizji dla modułu w domyślnej regule

Oznacza, że ‘Get-PackageUpdateSetting’ zgłasza potrzebę aktualizacji, gdy wersja rewizji modułu się zmienia.

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 moduł 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 czas, który musi upłynąć, aby wykonać nową kontrolę aktualizacji modułu

Domyślna wartość 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

Jeśli ta opcja jest włączona, żadna akcja nie zostanie wykonana, a zamiast tego wyświetlone zostaną komunikaty informacyjne wyjaśniają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, i -WarningVariable. Więcej informacji znajdziesz w about_CommonParameters.