Dela via


Update-PSResource

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

Syntax

Default (Standard)

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 har installerats på den lokala datorn. Den här cmdleten ersätter cmdletarna Update-Module 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 installerar Update-PSResource 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.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:False
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-AuthenticodeCheck

Validerar signerade filer och katalogfiler i Windows.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:False
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Confirm

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

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:False
Stöder jokertecken:False
DontShow:False
Alias:jfr

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Credential

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

Parameteregenskaper

Typ:PSCredential
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Force

När det anges kringgår du kontrollerna för TrustRepository och AcceptLicense och uppdaterar paketet.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:False
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument: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.

Parameteregenskaper

Typ:

String[]

Standardvärde:*
Stöder jokertecken:True
DontShow:False

Parameteruppsättningar

(All)
Position:0
Obligatorisk:False
Värde från pipeline:True
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-PassThru

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

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:False
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Prerelease

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

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:False
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Quiet

Undertrycker förloppsinformation.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:False
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument: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 Prioritet värden har högre prioritet.

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

Parametern stöder * jokertecken. 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.

Parameteregenskaper

Typ:

String[]

Standardvärde:None
Stöder jokertecken:True
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Scope

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

  • CurrentUser
  • AllUsers

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

Parameteregenskaper

Typ:Microsoft.PowerShell.PSResourceGet.UtilClasses.ScopeType
Standardvärde:None
Godkända värden:CurrentUser, AllUsers
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-SkipDependencyCheck

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

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:False
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument: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.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-TrustRepository

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

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:False
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument: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 Paketversioner.

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 du [1.0.0.0, ] som versionsintervall.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:True
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-WhatIf

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

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:False
Stöder jokertecken:False
DontShow:False
Alias:Wi

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

CommonParameters

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

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.