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 i Update-Script z modułu Update-ModulePowerShellGet w wersji 2. Nowa wersja zasobu jest instalowana obok poprzednich wersji w nowym folderze w wersji.

Domyślnie Update-PSResource instaluje najnowszą wersję pakietu i wszystkie jego zależności bez usuwania zainstalowanych starszych wersji.

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, opcja AcceptLicense automatycznie akceptuje umowę licencyjną podczas aktualizacji.

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AuthenticodeCheck

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

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Credential

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

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

Po określeniu pomija sprawdzanie zaufania Repozytorium i AcceptLicense i aktualizuje pakiet.

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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).

Type:String[]
Position:0
Default value:"*"
Required:False
Accept pipeline input:True
Accept wildcard characters:True

-PassThru

Po określeniu zwraca obiekt PSResourceInfo dla zapisanego zasobu.

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Prerelease

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

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Quiet

Pomija informacje o postępie.

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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 priorytetów (najwyższy pierwszy), dopóki repozytorium nie zostanie znalezione zawierające pakiet. Repozytoria są sortowane według priorytetu, a następnie według nazwy. Wartości niższego priorytetu mają wyższy priorytet.

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

Parametr obsługuje * symbol wieloznaczny. W przypadku określenia wielu repozytoriów wszystkie nazwy muszą zawierać lub pomijać symbol wieloznaczny. Nie można określić kombinacji nazw z symbolami wieloznacznymi i bez ich używania.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-Scope

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

  • CurrentUser
  • AllUsers

Zakres domyślny to CurrentUser, który nie wymaga podniesienia uprawnień.

Type:Microsoft.PowerShell.PSResourceGet.UtilClasses.ScopeType
Accepted values:CurrentUser, AllUsers
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SkipDependencyCheck

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

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TemporaryPath

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TrustRepository

Pomiń monity o zaufanie do repozytorium. Monit o zaufanie do repozytorium występuje tylko wtedy, gdy repozytorium nie jest skonfigurowane jako zaufane.

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Version

Określa wersję zasobu do zwrócenia. 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 nuGet, zobacz Przechowywanie wersji pakietów.

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie jest uruchamiane.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Dane wejściowe

String[]

Dane wyjściowe

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo

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

Uwagi

Moduł definiuje udres jako alias dla elementu Update-PSResource.