Update-Module
Laddar ned och installerar den senaste versionen av angivna moduler från ett onlinegalleri till den lokala datorn.
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
Cmdleten Update-Module
installerar en moduls senaste version från ett onlinegalleri. Du uppmanas att bekräfta uppdateringen innan den installeras. Uppdateringar installeras endast för moduler som har installerats på den lokala datorn med Install-Module
. Update-Module
söker efter $env:PSModulePath
installerade moduler.
Det här är en proxy-cmdlet för Update-PSResource
cmdleten i Microsoft.PowerShell.PSResourceGet. Mer information finns i Update-PSResource.
Exempel
Exempel 1: Uppdatera alla moduler
Det här exemplet uppdaterar alla installerade moduler till den senaste versionen i ett onlinegalleri.
Update-Module
Exempel 2: Uppdatera en modul efter namn
Det här exemplet uppdaterar en specifik modul till den senaste versionen i ett onlinegalleri.
Update-Module -Name SpeculationControl
Update-Module
använder parametern Namn för att uppdatera en specifik modul, SpeculationControl.
Exempel 3: Visa vad händer om Update-Module körs
Det här exemplet gör ett konsekvensscenario för att visa vad som händer om Update-Module
körs. Kommandot körs inte.
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
använder parametern WhatIf för att visa vad som skulle hända om Update-Module
det kördes.
Exempel 4: Uppdatera en modul till en angiven version
I det här exemplet uppdateras en modul till en viss version. Versionen måste finnas i onlinegalleriet eller så visas ett fel.
Update-Module -Name SpeculationControl -RequiredVersion 1.0.14
Update-Module
använder parametern Namn för att ange modulen SpeculationControl. Parametern RequiredVersion anger versionen 1.0.14.
Exempel 5: Uppdatera en modul utan bekräftelse
Det här exemplet begär inte bekräftelse för att uppdatera modulen till den senaste versionen från ett onlinegalleri. Om modulen redan är installerad installerar force-parametern om modulen.
Update-Module -Name SpeculationControl -Force
Update-Module
använder parametern Namn för att ange modulen SpeculationControl. Force-parametern uppdaterar modulen utan att begära användarbekräftelse.
Parametrar
-AcceptLicense
Godkänn licensavtalet automatiskt under installationen om paketet kräver det.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AllowPrerelease
Gör att du kan uppdatera en modul med den nyare modulen markerad som en förhandsversion.
Proxy-cmdleten mappar den här parametern till parametern Prerelease för Update-PSResource
.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Uppmanar dig att bekräfta innan du kör Update-Module
.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Credential
Anger ett användarkonto som har behörighet att uppdatera en modul.
Type: | PSCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Force
Tvingar fram en uppdatering av varje angiven modul utan en uppmaning om att begära bekräftelse. Om modulen redan är installerad installerar Force om modulen.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MaximumVersion
Proxy-cmdleten använder värdet för den här parametern för att skapa en NuGet-versionssökningssträng för användning med parametern Version för Update-PSResource
.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Anger namnen på en eller flera moduler som ska uppdateras. Update-Module
söker efter $env:PSModulePath
de moduler som ska uppdateras. Om inga matchningar hittas i $env:PSModulePath
för det angivna modulnamnet uppstår ett fel.
Jokertecken accepteras i modulnamn. Om du lägger till jokertecken i det angivna namnet och inga matchningar hittas uppstår inget fel.
Type: | String[] |
Position: | 0 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | True |
-PassThru
Returnerar ett objekt som representerar det objekt som du arbetar med. Som standard genererar denna cmdlet inga utdata.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Proxy
Proxy-cmdleten ignorerar den här parametern eftersom den inte stöds av Update-PSResource
.
Type: | Uri |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ProxyCredential
Proxy-cmdleten ignorerar den här parametern eftersom den inte stöds av Update-PSResource
.
Type: | PSCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-RequiredVersion
Proxy-cmdleten använder värdet för den här parametern för att skapa en NuGet-versionssökningssträng för användning med parametern Version för Update-PSResource
.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Scope
Anger modulens installationsomfång. De acceptabla värdena för den här parametern är AllUsers och CurrentUser. Om omfång inte har angetts installeras uppdateringen i CurrentUser-omfånget .
Omfånget AllUsers kräver utökade behörigheter och installerar moduler på en plats som är tillgänglig för alla användare av datorn:
$env:ProgramFiles\PowerShell\Modules
CurrentUser kräver inte utökade behörigheter och installerar moduler på en plats som endast är tillgänglig för den aktuella användaren av datorn:
$HOME\Documents\PowerShell\Modules
När inget omfång har definierats anges standardvärdet baserat på PowerShellGet-versionen.
- I PowerShellGet version 2.0.0 och senare är standardinställningen CurrentUser, som inte kräver utökade installationer.
- I PowerShellGet 1.x-versioner är standardvärdet Allaanvändare, vilket kräver utökade installationer.
Type: | String |
Accepted values: | CurrentUser, AllUsers |
Position: | Named |
Default value: | CurrentUser |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Visar vad som skulle hända om Update-Module
körs. Cmdleten körs inte.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Indata
String[]
Utdata
Kommentarer
PowerShell innehåller följande alias för Update-Module
:
- Alla plattformar:
upmo
För PowerShell version 6.0 och senare är standardinstallationsomfånget alltid CurrentUser.
Moduluppdateringar för CurrentUser, $HOME\Documents\PowerShell\Modules
, behöver inte utökade behörigheter. Moduluppdateringar för AllUsers, $env:ProgramFiles\PowerShell\Modules
, behöver utökade behörigheter.
PowerShell-galleriet har inte längre stöd för TLS-versionerna 1.0 och 1.1. Du måste använda TLS 1.2 eller senare. Använd följande kommando för att kontrollera att du använder TLS 1.2:
[Net.ServicePointManager]::SecurityProtocol = [Net.ServicePointManager]::SecurityProtocol -bor [Net.SecurityProtocolType]::Tls12
Update-Module
körs på PowerShell 3.0 eller senare versioner av PowerShell, i Windows 7 eller Windows 2008 R2 och senare versioner av Windows.
Om modulen som du anger med parametern Namn inte har installerats med , Install-Module
uppstår ett fel.
Du kan bara köra Update-Module
på moduler som du har installerat från onlinegalleriet genom att köra Install-Module
.
Om Update-Module
försöker uppdatera binärfiler som används Update-Module
returnerar ett fel som identifierar problemprocesserna. Användaren informeras om att försöka Update-Module
igen när processerna har stoppats.
Relaterade länkar
PSResourceGet