Dela via


Update-PSResource

Laddar ned och installerar den senaste versionen av ett paket som redan är installerat på den lokala datorn.

Syntax

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

Description

Update-PSResource laddar ned och installerar den senaste versionen av ett paket som redan är installerat på den lokala datorn. Den här cmdleten Update-Module ersätter cmdletarna och Update-Script från PowerShellGet v2. Den nya versionen av resursen installeras sida vid sida med tidigare versioner i en ny version av mappen.

Som standard Update-PSResource installerar den senaste versionen av paketet och något av dess beroenden utan att ta bort de äldre versionerna installerade. Det finns inget kommando för att avinstallera äldre versioner av ett paket. Du måste ta bort filer och mappar för de äldre versionerna manuellt.

Update-PSResource läser inte in den uppdaterade modulen i den aktuella sessionen. Du måste importera den nya versionen eller starta en ny session för att använda den uppdaterade modulen. Mer information finns i Import-Module.

Exempel

Exempel 1

I det här exemplet har användaren redan TestModule-paketet installerat och de uppdaterar paketet.

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

Parametrar

-AcceptLicense

För resurser som kräver en licens godkänner AcceptLicense automatiskt licensavtalet under uppdateringen.

Typ:SwitchParameter
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-AuthenticodeCheck

Validerar signerade filer och katalogfiler i Windows.

Typ:SwitchParameter
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Typ:SwitchParameter
Alias:cf
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Credential

Anger valfria autentiseringsuppgifter som används vid åtkomst till en privat lagringsplats.

Typ:PSCredential
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Force

När det anges kringgår söker efter TrustRepository och AcceptLicense och uppdaterar paketet.

Typ:SwitchParameter
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Name

Anger namnet på en eller flera resurser som ska uppdateras. Jokertecken stöds men NuGet accepterar * bara tecknet. NuGet stöder inte jokerteckensökningar av lokala (filbaserade) lagringsplatser.

Typ:String[]
Position:0
Standardvärde:"*"
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:True

-PassThru

När det anges matar ett PSResourceInfo-objekt ut för den sparade resursen.

Typ:SwitchParameter
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Prerelease

När det anges tillåter du uppdatering till en förhandsversion.

Typ:SwitchParameter
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Quiet

Undertrycker förloppsinformation.

Typ:SwitchParameter
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Repository

Anger ett eller flera lagringsplatsnamn som ska sökas. Om det inte anges innehåller sökningen alla registrerade lagringsplatser i prioritetsordning (högst först) tills en lagringsplats hittas som innehåller paketet. Lagringsplatser sorteras efter prioritet och sedan efter namn. Lägre prioritetsvärden har högre prioritet.

När du söker efter resurser på flera lagringsplatser söker PSResourceGet-cmdletarna igenom lagringsplatserna med hjälp av den här sorteringsordningen. Update-PSResource uppdaterar det första matchande paketet från den sorterade listan med lagringsplatser.

Parametern stöder * jokertecknet. Om du anger flera lagringsplatser måste alla namn inkludera eller utelämna jokertecknet. Du kan inte ange en blandning av namn med och utan jokertecken.

Typ:String[]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:True

-Scope

Anger installationsomfånget. Godkända värden är:

  • CurrentUser
  • AllUsers

Standardomfånget är CurrentUser, som inte kräver utökade privilegier.

Typ:Microsoft.PowerShell.PSResourceGet.UtilClasses.ScopeType
Godkända värden:CurrentUser, AllUsers
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-SkipDependencyCheck

Hoppar över kontrollen av resursberoenden. Det innebär att endast namngivna resurser uppdateras.

Typ:SwitchParameter
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-TemporaryPath

Anger sökvägen för att tillfälligt installera resursen före faktisk installatoin. Om det inte finns någon tillfällig sökväg installeras resursen tillfälligt i den aktuella användarens temporära mapp.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-TrustRepository

Ignorera uppmaningar om att lita på lagringsplatsen. Uppmaningen att lita på lagringsplatsen sker endast om lagringsplatsen inte är konfigurerad som betrodd.

Typ:SwitchParameter
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Version

Anger vilken version av resursen som ska returneras. Värdet kan vara en exakt version eller ett versionsintervall med hjälp av NuGet-versionssyntaxen.

Mer information om NuGet-versionsintervall finns i Paketversionshantering.

PowerShellGet stöder alla utom den lägsta inkluderande versionen som anges i dokumentationen för NuGet-versionsintervallet. Att använda 1.0.0.0 som version ger inte version 1.0.0.0 och högre (minsta inkluderande intervall). I stället anses värdet vara den version som krävs. Om du vill söka efter ett minsta inkluderande intervall använder [1.0.0.0, ] du som versionsintervall.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:True

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

Typ:SwitchParameter
Alias:wi
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

String[]

Utdata

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo

Som standard returnerar cmdleten inga objekt. När parametern PassThru används matar cmdleten ut ett PSResourceInfo-objekt för den sparade resursen.

Kommentarer

Modulen definierar udres som ett alias för Update-PSResource.