Update-Module
Downloadt en installeert de nieuwste versie van de opgegeven modules vanuit een onlinegalerie naar de lokale computer.
Syntax
All
Update-Module
[[-Name] <String[]>]
[-RequiredVersion <Version>]
[-MaximumVersion <Version>]
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
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.
Update-Module zonder opgegeven parameters worden alle geïnstalleerde modules bijgewerkt. Als u een module wilt opgeven die moet worden bijgewerkt, gebruikt u de parameter Name. U kunt bijwerken naar de specifieke versie van een module met behulp van de parameter RequiredVersion.
Als een geïnstalleerde module al de nieuwste versie is, wordt de module niet bijgewerkt. Als de module niet wordt gevonden in $env:PSModulePath, wordt er een fout weergegeven.
Gebruik Get-InstalledModuleom de geïnstalleerde modules weer te geven.
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 om een specifieke module bij te werken, SpeculatieControl.
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 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.
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 op te geven, SpeculatieControle. De parameter RequiredVersion specificeert de versie 1.0.14.
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 op te geven, SpeculatieControle. De parameter Forceren werkt de module bij zonder dat de gebruiker om bevestiging wordt gevraagd.
Parameters
-Confirm
Vraagt u om bevestiging voordat u Update-Moduleuitvoert.
Parametereigenschappen
| Type: | SwitchParameter |
| Default value: | False |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
| Aliassen: | Cf |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | 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.
Parametereigenschappen
| Type: | SwitchParameter |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | 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 MaximumVersion en de parameters RequiredVersion kunnen niet worden gebruikt in dezelfde opdracht.
Parametereigenschappen
| Type: | Version |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | True |
| Waarde van resterende argumenten: | False |
-Name
Hiermee geeft u de namen van een of meer modules die moeten worden bijgewerkt.
Update-Module zoekt $env:PSModulePath naar 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.
Parametereigenschappen
| Type: | String[] |
| Default value: | None |
| Ondersteunt jokertekens: | True |
| DontShow: | False |
Parametersets
(All)
| Position: | 0 |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | True |
| Waarde van resterende argumenten: | 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.
Parametereigenschappen
| Type: | Version |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | True |
| Waarde van resterende argumenten: | False |
-WhatIf
Laat zien wat er zou gebeuren als Update-Module wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.
Parametereigenschappen
| Type: | SwitchParameter |
| Default value: | False |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
| Aliassen: | Wi |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
CommonParameters
Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.
Notities
Voor PowerShell 5.1 of lager is het standaardbereik in een sessie met verhoogde bevoegdheid AllUsersen in een sessie zonder verhoogde bevoegdheid, CurrentUser-. Module-updates voor AllUsers, $env:ProgramFiles\PowerShell\Modules, hebben verhoogde machtigingen nodig. Module-updates voor CurrentUser, $home\Documents\PowerShell\Modules, hebben geen verhoogde machtigingen nodig.
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 met behulp van Install-Module, treedt 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.