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
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 parametru
| Typ: | SwitchParameter |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowe: | 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 parametru
| Typ: | SwitchParameter |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowe: | 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 parametru
| Typ: | SwitchParameter |
| Domyślna wartość: | False |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
| Aliasy: | por |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowe: | 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 parametru
| Typ: | PSCredential |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowe: | 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 parametru
| Typ: | SwitchParameter |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowe: | 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 parametru
| Typ: | String |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowe: | 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 parametru
| Typ: | String[] |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | True |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | 0 |
| Obowiązkowe: | 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 parametru
| Typ: | SwitchParameter |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowe: | 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 parametru
| Typ: | Uri |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowe: | 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 parametru
| Typ: | PSCredential |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowe: | 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 parametru
| Typ: | String |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowe: | 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 parametru
| Typ: | String |
| Domyślna wartość: | CurrentUser |
| Dopuszczalne wartości: | CurrentUser, AllUsers |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowe: | 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 parametru
| Typ: | SwitchParameter |
| Domyślna wartość: | False |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
| Aliasy: | Wi |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowe: | 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.
Dane wejściowe
String
String
PSCredential
Uri
Dane wyjściowe
Object
Uwagi
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 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.