Update-Module

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

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

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

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

Update-Module

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 om een specifieke module bij te werken, SpeculatieControl.

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 de parameter WhatIf gebruikt, wordt weergegeven wat er zou gebeuren als Update-Module werd uitgevoerd.

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 op te geven, SpeculatieControle. De parameter RequiredVersion specificeert de versie 1.0.14.

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

Update-Module -Name SpeculationControl -Force

Update-Module gebruikt de parameter Name om de module op te geven, SpeculatieControle. De parameter Forceren werkt de module bij zonder dat de gebruiker om bevestiging wordt gevraagd.

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

PowerShell bevat de volgende aliassen voor Update-Module:

• Alle platforms:
  • 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 hoger van PowerShell, in 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, Install-Moduletreedt er een fout op.

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

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