Delen via

Update-Module

  • Referentie
Module:
PowerShellGet

Downloadt en installeert de nieuwste versie van opgegeven modules vanuit een onlinegalerie op de lokale computer.

Syntax

Update-Module
      [[-Name] <String[]>]
      [-RequiredVersion <String>]
      [-MaximumVersion <String>]
      [-Credential <PSCredential>]
      [-Scope <String>]
      [-Proxy <Uri>]
      [-ProxyCredential <PSCredential>]
      [-Force]
      [-AllowPrerelease]
      [-AcceptLicense]
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

De Update-Module cmdlet installeert de nieuwste versie van een module vanuit een onlinegalerie. U wordt gevraagd de update te bevestigen voordat deze wordt geïnstalleerd. Updates worden alleen geïnstalleerd voor modules die zijn geïnstalleerd op de lokale computer met Install-Module. Update-Module zoekt naar $env:PSModulePath geïnstalleerde modules.

Dit is een proxy-cmdlet voor de Update-PSResource cmdlet in Microsoft.PowerShell.PSResourceGet. Zie Update-PSResource voor meer informatie.

Voorbeelden

Voorbeeld 1: Alle modules bijwerken

In dit voorbeeld worden alle geïnstalleerde modules bijgewerkt naar de nieuwste versie in een onlinegalerie.

Update-Module

Voorbeeld 2: Een module bijwerken op naam

In dit voorbeeld wordt een specifieke module bijgewerkt naar de nieuwste versie in een onlinegalerie.

Update-Module -Name SpeculationControl

Update-Module gebruikt de parameter Name voor het bijwerken van een specifieke module , SpeculatieBesturingselement.

Voorbeeld 3: wat-als-Update-Module-uitvoeringen weergeven

In dit voorbeeld wordt een wat-als-scenario uitgevoerd om te laten zien wat er gebeurt als Update-Module wordt uitgevoerd. De opdracht wordt niet uitgevoerd.

Update-Module -WhatIf

What if: Performing the operation "Update-Module" on target "Version '2.8.0' of module
  'Carbon', updating to version '2.8.1'".
What if: Performing the operation "Update-Module" on target "Version '1.0.10' of module
  'SpeculationControl', updating to version '1.0.14'".

Update-Module gebruikt de whatif-parameter om weer te geven wat er zou gebeuren als Update-Module deze zou worden uitgevoerd.

Voorbeeld 4: Een module bijwerken naar een opgegeven versie

In dit voorbeeld wordt een module bijgewerkt naar een specifieke versie. De versie moet aanwezig zijn in de onlinegalerie of er wordt een fout weergegeven.

Update-Module -Name SpeculationControl -RequiredVersion 1.0.14

Update-Module gebruikt de parameter Name om de module Speculatiecontrol op te geven. De parameter RequiredVersion geeft de versie 1.0.14 op.

Voorbeeld 5: Een module bijwerken zonder bevestiging

In dit voorbeeld wordt geen bevestiging gevraagd om de module vanuit een onlinegalerie bij te werken naar de nieuwste versie. Als de module al is geïnstalleerd, wordt de module opnieuw geïnstalleerd met de parameter Force .

Update-Module -Name SpeculationControl -Force

Update-Module gebruikt de parameter Name om de module Speculatiecontrol op te geven. De parameter Force werkt de module bij zonder bevestiging van de gebruiker te vragen.

Parameters

-AcceptLicense

Accepteer de gebruiksrechtovereenkomst automatisch tijdens de installatie als het pakket dit vereist.

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

-AllowPrerelease

Hiermee kunt u een module bijwerken met de nieuwere module gemarkeerd als een voorlopige versie.

De proxy-cmdlet wijst deze parameter toe aan de prerelease-parameter van Update-PSResource.

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

-Confirm

U wordt om bevestiging gevraagd voordat u uitvoert Update-Module.

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

-Credential

Hiermee geeft u een gebruikersaccount op dat gemachtigd is om een module bij te werken.

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

-Force

Hiermee wordt een update van elke opgegeven module gesmeerd zonder een prompt om bevestiging te vragen. Als de module al is geïnstalleerd, wordt de module geforceerd opnieuw geïnstalleerd.

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

-MaximumVersion

De proxy-cmdlet gebruikt de waarde van deze parameter om een zoekreeks voor een NuGet-versie te maken voor gebruik met de versieparameter van Update-PSResource.

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

-Name

Hiermee geeft u de namen van een of meer modules bij te werken. Update-Module zoekt naar $env:PSModulePath de modules die moeten worden bijgewerkt. Als er geen overeenkomsten worden gevonden in $env:PSModulePath voor de opgegeven modulenaam, treedt er een fout op.

Jokertekens worden geaccepteerd in modulenamen. Als u jokertekens toevoegt aan de opgegeven naam en er geen overeenkomsten worden gevonden, treedt er geen fout op.

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

-PassThru

Retourneert een object dat het item vertegenwoordigt waarmee u werkt. Deze cmdlet genereert standaard geen uitvoer.

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

-Proxy

De proxy-cmdlet negeert deze parameter omdat deze niet wordt ondersteund door Update-PSResource.

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

-ProxyCredential

De proxy-cmdlet negeert deze parameter omdat deze niet wordt ondersteund door Update-PSResource.

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

-RequiredVersion

De proxy-cmdlet gebruikt de waarde van deze parameter om een zoekreeks voor een NuGet-versie te maken voor gebruik met de versieparameter van Update-PSResource.

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

-Scope

Hiermee geeft u het installatiebereik van de module op. De acceptabele waarden voor deze parameter zijn AllUsers en CurrentUser. Als Bereik niet is opgegeven, wordt de update geïnstalleerd in het bereik CurrentUser .

Het bereik AllUsers vereist verhoogde machtigingen en installeert modules op een locatie die toegankelijk is voor alle gebruikers van de computer:

$env:ProgramFiles\PowerShell\Modules

De CurrentUser vereist geen verhoogde machtigingen en installeert modules op een locatie die alleen toegankelijk is voor de huidige gebruiker van de computer:

$HOME\Documents\PowerShell\Modules

Wanneer er geen bereik is gedefinieerd, wordt de standaardwaarde ingesteld op basis van de PowerShellGet-versie.

  • In PowerShellGet-versies 2.0.0 en hoger is de standaardwaarde CurrentUser, waarvoor geen uitbreiding van de installatie is vereist.
  • In PowerShellGet 1.x-versies is de standaardinstelling AllUsers, waarvoor uitbreiding van de installatie is vereist.
Type:String
Accepted values:CurrentUser, AllUsers
Position:Named
Default value:CurrentUser
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Laat zien wat er zou gebeuren als Update-Module wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

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

Invoerwaarden

String[]

String

PSCredential

Uri

Uitvoerwaarden

Object

Notities

PowerShell bevat de volgende aliassen voor Update-Module:

  • Alle platformen:
    • upmo

Voor PowerShell versie 6.0 en hoger is het standaardinstallatiebereik altijd CurrentUser. Module-updates voor CurrentUser, $HOME\Documents\PowerShell\Modules, hebben geen verhoogde machtigingen nodig. Module-updates voor AllUsers, $env:ProgramFiles\PowerShell\Modules, hebben verhoogde machtigingen nodig.

De PowerShell Gallery biedt geen ondersteuning meer voor TLS-versies (Transport Layer Security) 1.0 en 1.1. U moet TLS 1.2 of hoger gebruiken. Gebruik de volgende opdracht om ervoor te zorgen dat u TLS 1.2 gebruikt:

[Net.ServicePointManager]::SecurityProtocol = [Net.ServicePointManager]::SecurityProtocol -bor [Net.SecurityProtocolType]::Tls12

Update-Module wordt uitgevoerd op PowerShell 3.0 of latere versies van PowerShell, op Windows 7 of Windows 2008 R2 en latere versies van Windows.

Als de module die u opgeeft met de parameter Name niet is geïnstalleerd met , Install-Moduletreedt er een fout op.

U kunt alleen uitvoeren Update-Module op modules die u hebt geïnstalleerd vanuit de onlinegalerie door uit te voeren Install-Module.

Als Update-Module wordt geprobeerd binaire bestanden bij te werken die in gebruik zijn, Update-Module retourneert een fout die de probleemprocessen identificeert. De gebruiker wordt geïnformeerd om het opnieuw te proberen Update-Module nadat de processen zijn gestopt.