Update-Module
Pobiera i instaluje najnowszą wersję określonych modułów z galerii online na komputerze lokalnym.
Składnia
All
Update-Module
[[-Name] <String[]>]
[-RequiredVersion <String>]
[-MaximumVersion <String>]
[-Credential <PSCredential>]
[-Scope <String>]
[-Proxy <Uri>]
[-ProxyCredential <PSCredential>]
[-Force]
[-AllowPrerelease]
[-AcceptLicense]
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Opis
Polecenie cmdlet Update-Module instaluje najnowszą wersję modułu z galerii online. Zostanie wyświetlony monit o potwierdzenie aktualizacji przed jej zainstalowaniem. Aktualizacje są instalowane tylko dla modułów zainstalowanych na komputerze lokalnym z Install-Module.
Update-Module wyszukuje $env:PSModulePath dla zainstalowanych modułów.
Update-Module bez określonych parametrów aktualizuje wszystkie zainstalowane moduły. Aby określić moduł do aktualizacji, użyj parametru nazwa
Parametry, które przyjmują numery wersji modułu, oczekują ciągów sformatowanych jako numery wersji.
- Numery wersji standardowej
x.y.zmają format, w którym liczby x, y i z - Wersje wstępne mają format
x.y.z-<prerelease_label>, w którym<prerelease_label>jest przypisany dowolny ciąg do tej wersji.
Jeśli zainstalowany moduł jest już najnowszą wersją, moduł nie jest aktualizowany. Jeśli moduł nie zostanie znaleziony w $env:PSModulePath, zostanie wyświetlony błąd.
Aby wyświetlić zainstalowane moduły, użyj Get-InstalledModule.
Przykłady
Przykład 1. Aktualizowanie wszystkich modułów
W tym przykładzie wszystkie zainstalowane moduły są aktualizowane do najnowszej wersji w galerii online.
Update-Module
Przykład 2. Aktualizowanie modułu według nazwy
W tym przykładzie zaktualizowano określony moduł do najnowszej wersji w galerii online.
Update-Module -Name SpeculationControl
Przykład 3. Wyświetlanie przebiegów Update-Module analizy co-jeżeli
W tym przykładzie przedstawiono scenariusz analizy warunkowej, który pokazuje, co się stanie w przypadku uruchomienia Update-Module. Polecenie nie jest uruchamiane.
Update-Module -WhatIf
What if: Performing the operation "Update-Module" on target "Version '2.8.0' of module
'Carbon', updating to version '2.8.1'".
What if: Performing the operation "Update-Module" on target "Version '1.0.10' of module
'SpeculationControl', updating to version '1.0.14'".
Update-Module używa parametru WhatIf, co się stanie, jeśli Update-Module zostały uruchomione.
Przykład 4. Aktualizowanie modułu do określonej wersji
W tym przykładzie moduł jest aktualizowany do określonej wersji. Wersja musi istnieć w galerii online lub zostanie wyświetlony błąd.
Update-Module -Name SpeculationControl -RequiredVersion 1.0.14
Update-Module używa parametru Name w celu określenia modułu SpeculationControl. Parametr RequiredVersion określa wersję 1.0.14.
Przykład 5. Aktualizowanie modułu bez potwierdzenia
W tym przykładzie nie jest wymagane potwierdzenie aktualizacji modułu do najnowszej wersji z galerii online. Jeśli moduł jest już zainstalowany, parametr Force ponownie zainstaluje moduł.
Update-Module -Name SpeculationControl -Force
Update-Module używa parametru Name w celu określenia modułu SpeculationControl. Parametr Force aktualizuje moduł bez żądania potwierdzenia użytkownika.
Parametry
-AcceptLicense
Automatycznie zaakceptuj umowę licencyjną podczas instalacji, jeśli pakiet tego wymaga.
Właściwości parametrów
| Typ: | SwitchParameter |
| Wartość domyślna: | None |
| Obsługuje symbole wieloznaczne: | False |
| Nie pokaż: | False |
Zestawy parametrów
(All)
| Pozycja: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-AllowPrerelease
Umożliwia zaktualizowanie modułu przy użyciu nowszego modułu oznaczonego jako wydanie wstępne.
Właściwości parametrów
| Typ: | SwitchParameter |
| Wartość domyślna: | None |
| Obsługuje symbole wieloznaczne: | False |
| Nie pokaż: | False |
Zestawy parametrów
(All)
| Pozycja: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-Confirm
Prosi o potwierdzenie przed uruchomieniem Update-Module.
Właściwości parametrów
| Typ: | SwitchParameter |
| Wartość domyślna: | False |
| Obsługuje symbole wieloznaczne: | False |
| Nie pokaż: | False |
| Aliasy: | por |
Zestawy parametrów
(All)
| Pozycja: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-Credential
Określa konto użytkownika, które ma uprawnienia do aktualizowania modułu.
Właściwości parametrów
| Typ: | PSCredential |
| Wartość domyślna: | None |
| Obsługuje symbole wieloznaczne: | False |
| Nie pokaż: | False |
Zestawy parametrów
(All)
| Pozycja: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | True |
| Wartość z pozostałych argumentów: | False |
-Force
Wymusza aktualizację każdego określonego modułu bez monitu o potwierdzenie. Jeśli moduł jest już zainstalowany, Force ponownie zainstaluje moduł.
Właściwości parametrów
| Typ: | SwitchParameter |
| Wartość domyślna: | None |
| Obsługuje symbole wieloznaczne: | False |
| Nie pokaż: | False |
Zestawy parametrów
(All)
| Pozycja: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-MaximumVersion
Określa maksymalną wersję pojedynczego modułu do aktualizacji. Nie można dodać tego parametru, jeśli próbujesz zaktualizować wiele modułów. Nie można użyć parametrów
Właściwości parametrów
| Typ: | String |
| Wartość domyślna: | None |
| Obsługuje symbole wieloznaczne: | False |
| Nie pokaż: | False |
Zestawy parametrów
(All)
| Pozycja: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | True |
| Wartość z pozostałych argumentów: | False |
-Name
Określa nazwy co najmniej jednego modułu do aktualizacji.
Update-Module wyszukuje $env:PSModulePath modułów do aktualizacji. Jeśli nie znaleziono dopasowań w $env:PSModulePath dla określonej nazwy modułu, wystąpi błąd.
Symbole wieloznaczne są akceptowane w nazwach modułów. W przypadku dodawania symboli wieloznacznych do określonej nazwy i nie znaleziono dopasowań, nie wystąpi błąd.
Właściwości parametrów
| Typ: | String[] |
| Wartość domyślna: | None |
| Obsługuje symbole wieloznaczne: | True |
| Nie pokaż: | False |
Zestawy parametrów
(All)
| Pozycja: | 0 |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | True |
| Wartość z pozostałych argumentów: | False |
-PassThru
Zwraca obiekt reprezentujący element, z którym pracujesz. Domyślnie to polecenie cmdlet nie generuje żadnych danych wyjściowych.
Właściwości parametrów
| Typ: | SwitchParameter |
| Wartość domyślna: | None |
| Obsługuje symbole wieloznaczne: | False |
| Nie pokaż: | False |
Zestawy parametrów
(All)
| Pozycja: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-Proxy
Określa serwer proxy dla żądania, zamiast łączyć się bezpośrednio z zasobem internetowym.
Właściwości parametrów
| Typ: | Uri |
| Wartość domyślna: | None |
| Obsługuje symbole wieloznaczne: | False |
| Nie pokaż: | False |
Zestawy parametrów
(All)
| Pozycja: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | True |
| Wartość z pozostałych argumentów: | False |
-ProxyCredential
Określa konto użytkownika, które ma uprawnienia do korzystania z serwera proxy określonego przez parametr proxy .
Właściwości parametrów
| Typ: | PSCredential |
| Wartość domyślna: | None |
| Obsługuje symbole wieloznaczne: | False |
| Nie pokaż: | False |
Zestawy parametrów
(All)
| Pozycja: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | True |
| Wartość z pozostałych argumentów: | False |
-RequiredVersion
Określa dokładną wersję, do której zostanie zaktualizowany istniejący zainstalowany moduł. Wersja określona przez RequiredVersion musi istnieć w galerii online lub zostanie wyświetlony błąd. Jeśli więcej niż jeden moduł zostanie zaktualizowany w jednym poleceniu, nie można użyć RequiredVersion.
Właściwości parametrów
| Typ: | String |
| Wartość domyślna: | None |
| Obsługuje symbole wieloznaczne: | False |
| Nie pokaż: | False |
Zestawy parametrów
(All)
| Pozycja: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | True |
| Wartość z pozostałych argumentów: | False |
-Scope
Określa zakres instalacji modułu. Dopuszczalne wartości tego parametru to AllUsers i CurrentUser. Jeśli zakres nie zostanie określony, aktualizacja zostanie zainstalowana w zakresie CurrentUser .
Zakres AllUsers wymaga podwyższonych uprawnień i instaluje moduły w lokalizacji dostępnej dla wszystkich użytkowników komputera:
$env:ProgramFiles\PowerShell\Modules
Bieżący użytkownik nie wymaga uprawnień z podwyższonym poziomem uprawnień i instaluje moduły w lokalizacji dostępnej tylko dla bieżącego użytkownika komputera:
$HOME\Documents\PowerShell\Modules
Jeśli zakres nie jest zdefiniowany, wartość domyślna jest ustawiana na podstawie wersji modułu PowerShellGet.
- W programie PowerShellGet w wersji 2.0.0 lub nowszej wartość domyślna to CurrentUser, która nie wymaga podniesienia uprawnień do instalacji.
- W wersjach PowerShellGet 1.x wartość domyślna to AllUsers, która wymaga podniesienia uprawnień do instalacji.
Właściwości parametrów
| Typ: | String |
| Wartość domyślna: | CurrentUser |
| Akceptowane wartości: | CurrentUser, AllUsers |
| Obsługuje symbole wieloznaczne: | False |
| Nie pokaż: | False |
Zestawy parametrów
(All)
| Pozycja: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-WhatIf
Pokazuje, co się stanie, jeśli Update-Module zostanie uruchomiony. Cmdlet nie został uruchomiony.
Właściwości parametrów
| Typ: | SwitchParameter |
| Wartość domyślna: | False |
| Obsługuje symbole wieloznaczne: | False |
| Nie pokaż: | False |
| Aliasy: | Wi |
Zestawy parametrów
(All)
| Pozycja: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
CommonParameters
To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.
Wejścia
String
String
PSCredential
Uri
Wyjść
Object
Notatki
Program PowerShell zawiera następujące aliasy dla Update-Module:
- Wszystkie platformy:
upmo
W przypadku programu PowerShell w wersji 6.0 lub nowszej domyślny zakres instalacji to zawsze CurrentUser.
Aktualizacje modułu dla CurrentUser, $HOME\Documents\PowerShell\Modulesnie wymagają podwyższonych uprawnień. Aktualizacje modułu dla AllUsers, $env:ProgramFiles\PowerShell\Modules, wymagają podwyższonych uprawnień.
Ważne
Od kwietnia 2020 r. galeria programu PowerShell nie obsługuje już protokołu Transport Layer Security (TLS) w wersji 1.0 i 1.1. Jeśli nie używasz protokołu TLS 1.2 lub nowszego, podczas próby uzyskania dostępu do galerii programu PowerShell zostanie wyświetlony błąd. Użyj następującego polecenia, aby upewnić się, że używasz protokołu TLS 1.2:
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
Aby uzyskać więcej informacji, zobacz anons w blogu programu PowerShell.
Update-Module działa w wersjach programu PowerShell 3.0 lub nowszych, w systemach Windows 7 lub Windows 2008 R2 i nowszych wersjach systemu Windows.
Jeśli moduł określony za pomocą parametru Name nie został zainstalowany przy użyciu polecenia Install-Module, wystąpi błąd.
Można uruchomić Update-Module tylko w modułach zainstalowanych z galerii online, uruchamiając Install-Module.
Jeśli Update-Module próbuje zaktualizować pliki binarne, które są używane, Update-Module zwraca błąd, który identyfikuje procesy problemu. Użytkownik jest informowany o ponowieniu próby Update-Module po zatrzymaniu procesów.
