Update-Module
Downloadt en installeert de nieuwste versie van de opgegeven modules vanuit een onlinegalerie naar de lokale computer.
Syntaxis
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 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 naar $env:PSModulePath geïnstalleerde modules.
Update-Module zonder opgegeven parameters worden alle geïnstalleerde modules bijgewerkt. Gebruik de parameter Name om een module op te geven die moet worden bijgewerkt. U kunt bijwerken naar de specifieke versie van een module met behulp van de parameter RequiredVersion .
De parameters die moduleversienummers gebruiken, verwachten tekenreeksen die zijn opgemaakt als versienummers.
- Standaardversienummers hebben een notatie waarbij
x.y.zx, y en z getallen zijn - Prerelease-versies hebben een indeling waarin
x.y.z-<prerelease_label>de<prerelease_label>willekeurige tekenreeks is toegewezen aan die release.
Als een geïnstalleerde module al de nieuwste versie is, wordt de module niet bijgewerkt. Als de module niet wordt gevonden, $env:PSModulePathwordt er een fout weergegeven.
Als u de geïnstalleerde modules wilt weergeven, gebruikt u Get-InstalledModule.
Voorbeelden
Voorbeeld 1: Alle modules bijwerken
In dit voorbeeld worden alle geïnstalleerde modules bijgewerkt naar de nieuwste versie in een onlinegalerie.
Update-ModuleVoorbeeld 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 om een specifieke module, SpeculatieControl, bij te werken.
Voorbeeld 3: Wat-als-Update-Module wordt uitgevoerd
In dit voorbeeld wordt een wat-als-scenario uitgevoerd om te laten zien wat er gebeurt als Update-Module deze 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 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 SpeculatieControl op te geven. De parameter Force werkt de module bij zonder bevestiging van de gebruiker aan te vragen.
Parameters
-AcceptLicense
Accepteer automatisch de gebruiksrechtovereenkomst tijdens de installatie als het pakket dit vereist.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-AllowPrerelease
Hiermee kunt u een module bijwerken met de nieuwere module die is gemarkeerd als een voorlopige versie.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-Confirm
Vraagt u om bevestiging voordat u Update-Moduleuitvoert.
| Type: | SwitchParameter |
| Aliassen: | cf |
| Position: | Named |
| Default value: | False |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-Credential
Hiermee geeft u een gebruikersaccount op dat is gemachtigd om een module bij te werken.
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | True |
| Jokertekens accepteren: | False |
-Force
Hiermee dwingt u een update van elke opgegeven module af zonder een prompt om bevestiging aan te vragen. Als de module al is geïnstalleerd, installeert Force de module opnieuw.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-MaximumVersion
Hiermee geeft u de maximale versie van één module die moet worden bijgewerkt. U kunt deze parameter niet toevoegen als u meerdere modules probeert bij te werken. De Parameters MaximumVersion en RequiredVersion kunnen niet worden gebruikt in dezelfde opdracht.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | True |
| Jokertekens accepteren: | False |
-Name
Hiermee geeft u de namen van een of meer modules die moeten worden bijgewerkt.
Update-Module zoekt naar $env:PSModulePath de modules die moeten worden bijgewerkt. Als er geen overeenkomsten worden gevonden $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 |
| Vereist: | False |
| Pijplijninvoer accepteren: | True |
| Jokertekens accepteren: | True |
-PassThru
Retourneert een object dat het item aangeeft waarmee u werkt. Deze cmdlet genereert standaard geen uitvoer.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-Proxy
Hiermee geeft u een proxyserver voor de aanvraag op, in plaats van rechtstreeks verbinding te maken met een internetresource.
| Type: | Uri |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | True |
| Jokertekens accepteren: | False |
-ProxyCredential
Hiermee geeft u een gebruikersaccount op dat gemachtigd is om de proxyserver te gebruiken die is opgegeven door de parameter Proxy.
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | True |
| Jokertekens accepteren: | False |
-RequiredVersion
Hiermee geeft u de exacte versie op waarnaar de bestaande geïnstalleerde module wordt bijgewerkt. De versie die is opgegeven door RequiredVersion , moet aanwezig zijn in de onlinegalerie of er wordt een fout weergegeven. Als meer dan één module in één opdracht wordt bijgewerkt, kunt u RequiredVersion niet gebruiken.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | True |
| Jokertekens accepteren: | False |
-Scope
Hiermee geeft u het installatiebereik van de module. 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
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 standaard ingesteld op basis van de PowerShellGet-versie.
- In PowerShellGet-versies 2.0.0 en hoger is de standaardinstelling 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 |
| Geaccepteerde waarden: | CurrentUser, AllUsers |
| Position: | Named |
| Default value: | CurrentUser |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-WhatIf
Laat zien wat er zou gebeuren als Update-Module wordt uitgevoerd. 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
Notities
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\Moduleshebben geen verhoogde machtigingen nodig. Module-updates voor AllUsers, $env:ProgramFiles\PowerShell\Moduleshebben verhoogde machtigingen nodig.
Belangrijk
Vanaf april 2020 biedt de PowerShell Gallery geen ondersteuning meer voor TLS-versies (Transport Layer Security) 1.0 en 1.1. Als u TLS 1.2 of hoger niet gebruikt, krijgt u een foutmelding wanneer u toegang probeert te krijgen tot de PowerShell Gallery. Gebruik de volgende opdracht om ervoor te zorgen dat u TLS 1.2 gebruikt:
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
Zie de aankondiging in de PowerShell-blog voor meer informatie.
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 worden uitgevoerd Update-Module op modules die u hebt geïnstalleerd vanuit de onlinegalerie door deze uit te voeren Install-Module.
Als Update-Module probeert binaire bestanden bij te werken die in gebruik zijn, Update-Module retourneert u een fout die de probleemprocessen identificeert. De gebruiker wordt geïnformeerd om het opnieuw te proberen Update-Module nadat de processen zijn gestopt.
