Udostępnij za pośrednictwem

Update-PSResource

  • Odwołanie
Moduł:
Microsoft.PowerShell.PSResourceGet

Pobiera i instaluje najnowszą wersję pakietu zainstalowanego już na komputerze lokalnym.

Składnia

Update-PSResource
      [[-Name] <String[]>]
      [-Version <String>]
      [-Prerelease]
      [-Repository <String[]>]
      [-Scope <ScopeType>]
      [-TemporaryPath <String>]
      [-TrustRepository]
      [-Credential <PSCredential>]
      [-Quiet]
      [-AcceptLicense]
      [-Force]
      [-PassThru]
      [-SkipDependencyCheck]
      [-AuthenticodeCheck]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Opis

Update-PSResource pobiera i instaluje najnowszą wersję pakietu zainstalowanego już na komputerze lokalnym. To polecenie cmdlet zastępuje polecenia cmdlet Update-Module i Update-Script z PowerShellGet v2. Nowa wersja zasobu jest instalowana równolegle z poprzednimi wersjami w nowym folderze z wersją.

Domyślnie Update-PSResource instaluje najnowszą wersję pakietu i wszystkie jego zależności bez usuwania zainstalowanych starszych wersji. Nie ma polecenia, aby odinstalować starsze wersje pakietu. Należy ręcznie usunąć pliki i foldery starszych wersji.

Update-PSResource nie ładuje zaktualizowanego modułu do bieżącej sesji. Musisz zaimportować nową wersję lub uruchomić nową sesję, aby użyć zaktualizowanego modułu. Aby uzyskać więcej informacji, zobacz Import-Module.

Przykłady

Przykład 1

W tym przykładzie użytkownik ma już zainstalowany pakiet TestModule i aktualizuje pakiet.

Get-PSResource -Name "TestModule"

Name                                    Version                         Prerelease   Description
----                                    -------                         ----------   -----------
TestModule                              1.2.0                                        test

Update-PSResource -Name "TestModule"

Name                                    Version                         Prerelease   Description
----                                    -------                         ----------   -----------
TestModule                              1.3.0                                        test
TestModule                              1.2.0                                        test

Parametry

-AcceptLicense

W przypadku zasobów, które wymagają licencji, AcceptLicense automatycznie akceptuje umowę licencyjną podczas aktualizacji.

Typ:SwitchParameter
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-AuthenticodeCheck

Sprawdza poprawność podpisanych plików i plików wykazu w systemie Windows.

Typ:SwitchParameter
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Credential

Określa opcjonalne poświadczenia używane podczas uzyskiwania dostępu do repozytorium prywatnego.

Typ:PSCredential
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Force

Po określeniu pomija kontrole TrustRepository i AcceptLicense i aktualizuje pakiet.

Typ:SwitchParameter
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Name

Określa nazwę co najmniej jednego zasobu do zaktualizowania. Symbole wieloznaczne są obsługiwane, ale program NuGet akceptuje tylko znak *. Pakiet NuGet nie obsługuje wyszukiwania symboli wieloznacznych w lokalnych repozytoriach (opartych na plikach).

Typ:String[]
Position:0
Domyślna wartość:"*"
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:True

-PassThru

Po określeniu parametr zwraca obiekt PSResourceInfo dla zapisanego zasobu.

Typ:SwitchParameter
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Prerelease

Po określeniu parametru umożliwia aktualizowanie do wersji wstępnej.

Typ:SwitchParameter
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Quiet

Pomija informacje o postępie.

Typ:SwitchParameter
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Repository

Określa co najmniej jedną nazwę repozytorium do wyszukania. Jeśli nie zostanie określony, wyszukiwanie obejmuje wszystkie zarejestrowane repozytoria, w kolejności priorytetu (najwyższy pierwszy), dopóki repozytorium nie zostanie znalezione, które zawiera pakiet. Repozytoria są sortowane według priorytetu, a następnie według nazwy. Niższe wartości Priorytet mają wyższy priorytet.

Podczas wyszukiwania zasobów w wielu repozytoriach polecenia cmdlet PSResourceGet przeszukają repozytoria przy użyciu tej kolejności sortowania. Update-PSResource aktualizuje pierwszy pasujący pakiet z posortowanej listy repozytoriów.

Parametr obsługuje znak wieloznaczny *. Jeśli określisz wiele repozytoriów, wszystkie nazwy muszą zawierać lub pomijać symbol wieloznaczny. Nie można określić kombinacji nazw z symbolami wieloznacznymi i bez symboli wieloznacznych.

Typ:String[]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:True

-Scope

Określa zakres instalacji. Akceptowane wartości to:

  • CurrentUser
  • AllUsers

Domyślny zakres to CurrentUser, który nie wymaga podniesienia uprawnień.

Typ:Microsoft.PowerShell.PSResourceGet.UtilClasses.ScopeType
Dopuszczalne wartości:CurrentUser, AllUsers
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-SkipDependencyCheck

Pomija sprawdzanie zależności zasobów. Oznacza to, że aktualizowane są tylko nazwane zasoby.

Typ:SwitchParameter
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-TemporaryPath

Określa ścieżkę do tymczasowego zainstalowania zasobu przed rzeczywistą instalacją. Jeśli nie podano ścieżki tymczasowej, zasób jest tymczasowo zainstalowany w folderze tymczasowym bieżącego użytkownika.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-TrustRepository

Pomijanie monitów o zaufanie repozytorium. Monit o zaufanie do repozytorium występuje tylko wtedy, gdy repozytorium nie jest skonfigurowane jako zaufane.

Typ:SwitchParameter
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Version

Określa wersję zasobu, która ma zostać zwrócona. Wartość może być dokładną wersją lub zakresem wersji przy użyciu składni przechowywania wersji NuGet.

Aby uzyskać więcej informacji na temat zakresów wersji pakietu NuGet, zobacz Package versioning.

Moduł PowerShellGet obsługuje wszystkie elementy, ale minimalną wersję inkluzywną wymienioną w dokumentacji zakresu wersji NuGet. Użycie 1.0.0.0 jako wersji nie daje wersji 1.0.0.0 i wyższych (minimalny zakres włącznie). Zamiast tego wartość jest uważana za wymaganą wersję. Aby wyszukać minimalny zakres inkluzywny, użyj [1.0.0.0, ] jako zakresu wersji.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:True

-WhatIf

Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Polecenie cmdlet nie jest uruchamiane.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

String[]

Dane wyjściowe

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo

Domyślnie polecenie cmdlet nie zwraca żadnych obiektów. Gdy jest używany parametr PassThru, polecenie cmdlet zwraca obiekt PSResourceInfo dla zapisanego zasobu.

Uwagi

Moduł definiuje udres jako alias dla Update-PSResource.