Delen via

Update-PSResource

  • Referentie
Module:
Microsoft.PowerShell.PSResourceGet

Downloadt en installeert de nieuwste versie van een pakket dat al op de lokale computer is geïnstalleerd.

Syntaxis

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 downloadt en installeert de nieuwste versie van een pakket dat al op de lokale computer is geïnstalleerd. Deze cmdlet vervangt de Update-Module en Update-Script cmdlets van PowerShellGet v2. De nieuwe versie van de resource wordt naast eerdere versies geïnstalleerd in een nieuwe map met versiebeheer.

Installeert standaard Update-PSResource de nieuwste versie van het pakket en een van de bijbehorende afhankelijkheden zonder de oudere versies te verwijderen. Er is geen opdracht om oudere versies van een pakket te verwijderen. U moet de bestanden en mappen van de oudere versies handmatig verwijderen.

Update-PSResource laadt de bijgewerkte module niet in de huidige sessie. U moet de nieuwe versie importeren of een nieuwe sessie starten om de bijgewerkte module te kunnen gebruiken. Zie Import-Module voor meer informatie.

Voorbeelden

Voorbeeld 1

In dit voorbeeld heeft de gebruiker het TestModule-pakket al geïnstalleerd en wordt het pakket bijgewerkt.

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

Parameters

-AcceptLicense

Voor resources waarvoor een licentie is vereist, accepteert AcceptLicense automatisch de gebruiksrechtovereenkomst tijdens de update.

Type:SwitchParameter
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-AuthenticodeCheck

Hiermee worden ondertekende bestanden en catalogusbestanden in Windows gevalideerd.

Type:SwitchParameter
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Credential

Hiermee geeft u optionele referenties op die worden gebruikt bij het openen van een privéopslagplaats.

Type:PSCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Force

Wanneer dit is opgegeven, worden controles voor TrustRepository en AcceptLicense omzeild en wordt het pakket bijgewerkt.

Type:SwitchParameter
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Name

Hiermee geeft u de naam van een of meer resources die moeten worden bijgewerkt. Jokertekens worden ondersteund, maar NuGet accepteert alleen het * teken. NuGet biedt geen ondersteuning voor zoekopdrachten met jokertekens in lokale (op bestanden gebaseerde) opslagplaatsen.

Type:String[]
Position:0
Default value:"*"
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:True

-PassThru

Wanneer dit is opgegeven, wordt een PSResourceInfo-object uitgevoerd voor de opgeslagen resource.

Type:SwitchParameter
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Prerelease

Wanneer dit is opgegeven, kunt u bijwerken naar een voorlopige versie.

Type:SwitchParameter
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Quiet

Onderdrukt voortgangsinformatie.

Type:SwitchParameter
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Repository

Hiermee geeft u een of meer namen van opslagplaatsen om te zoeken. Als dit niet is opgegeven, bevat de zoekopdracht alle geregistreerde opslagplaatsen, in prioriteitsvolgorde (hoogste eerst), totdat een opslagplaats wordt gevonden die het pakket bevat. Opslagplaatsen worden gesorteerd op prioriteit en vervolgens op naam. Waarden met een lagere prioriteit hebben een hogere prioriteit.

Bij het zoeken naar resources in meerdere opslagplaatsen doorzoeken de PSResourceGet-cmdlets de opslagplaatsen met behulp van deze sorteervolgorde. Update-PSResource werkt het eerste overeenkomende pakket bij uit de gesorteerde lijst met opslagplaatsen.

De parameter ondersteunt het * jokerteken. Als u meerdere opslagplaatsen opgeeft, moeten alle namen het jokerteken bevatten of weglaten. U kunt geen combinatie van namen opgeven met en zonder jokertekens.

Type:String[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:True

-Scope

Hiermee geeft u het installatiebereik. Geaccepteerde waarden zijn:

  • CurrentUser
  • AllUsers

Het standaardbereik is CurrentUser, waarvoor geen uitbreiding is vereist.

Type:Microsoft.PowerShell.PSResourceGet.UtilClasses.ScopeType
Geaccepteerde waarden:CurrentUser, AllUsers
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-SkipDependencyCheck

Slaat de controle op resourceafhankelijkheden over. Dit betekent dat alleen benoemde resources worden bijgewerkt.

Type:SwitchParameter
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-TemporaryPath

Hiermee geeft u het pad op om de resource tijdelijk te installeren voordat de installatie daadwerkelijk wordt geïnstalleerd. Als er geen tijdelijk pad wordt opgegeven, wordt de resource tijdelijk geïnstalleerd in de tijdelijke map van de huidige gebruiker.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-TrustRepository

Onderdrukt prompts om de opslagplaats te vertrouwen. De prompt om de opslagplaats te vertrouwen vindt alleen plaats als de opslagplaats niet is geconfigureerd als vertrouwd.

Type:SwitchParameter
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Version

Hiermee geeft u de versie van de resource die moet worden geretourneerd. De waarde kan een exacte versie of een versiebereik zijn met behulp van de nuGet-versiebeheersyntaxis.

Zie Pakketversiebeheer voor meer informatie over NuGet-versiebereiken.

PowerShellGet biedt ondersteuning voor alle, maar de minimaal inbegrepen versie die wordt vermeld in de documentatie van het NuGet-versiebereik. Als 1.0.0.0 u de versie gebruikt, levert geen versies 1.0.0.0 en hoger op (minimaal inclusief bereik). In plaats daarvan wordt de waarde beschouwd als de vereiste versie. Als u wilt zoeken naar een minimaal inclusief bereik, gebruikt [1.0.0.0, ] u deze als versiebereik.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:True

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

String[]

Uitvoerwaarden

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo

Standaard retourneert de cmdlet geen objecten. Wanneer de parameter PassThru wordt gebruikt, voert de cmdlet een PSResourceInfo-object uit voor de opgeslagen resource.

Notities

De module definieert udres als een alias voor Update-PSResource.