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 $env:PSModulePath efter installerade moduler.
Update-Module utan angivna parametrar uppdaterar alla installerade moduler. Om du vill ange en modul som ska uppdateras använder du parametern Name. Du kan uppdatera till en moduls specifika version med hjälp av parametern RequiredVersion.
Om en installerad modul redan är den senaste versionen uppdateras inte modulen. Om modulen inte hittas i $env:PSModulePathvisas ett fel.
Om du vill visa de installerade modulerna använder du Get-InstalledModule.
Exempel
Exempel 1: Uppdatera alla moduler
I det här exemplet uppdateras alla installerade moduler till den senaste versionen i ett onlinegalleri.
Update-ModuleExempel 2: Uppdatera en modul efter namn
I det här exemplet uppdateras en specifik modul till den senaste versionen i ett onlinegalleri.
Update-Module -Name SpeculationControl
Update-Module använder parametern Name 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 som visar vad som skulle hända om Update-Module 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 Name 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 parametern Force om modulen.
Update-Module -Name SpeculationControl -Force
Update-Module använder parametern Name för att ange modulen SpeculationControl. Parametern Force uppdaterar modulen utan att begära användarbekräftelse.
Parametrar
-AcceptLicense
Godkänn licensavtalet automatiskt under installationen om paketet kräver det.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-AllowPrerelease
Gör att du kan uppdatera en modul med den nyare modulen markerad som en förhandsversion.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-Confirm
Uppmanar dig att bekräfta innan du kör Update-Module.
| Typ: | SwitchParameter |
| Alias: | cf |
| Position: | Named |
| Standardvärde: | False |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-Credential
Anger ett användarkonto som har behörighet att uppdatera en modul.
| Typ: | PSCredential |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | 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.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-MaximumVersion
Anger den maximala versionen av en enskild modul som ska uppdateras. Du kan inte lägga till den här parametern om du försöker uppdatera flera moduler. Parametrarna MaximumVersion och RequiredVersion kan inte användas i samma kommando.
| Typ: | String |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
-Name
Anger namnen på en eller flera moduler som ska uppdateras.
Update-Module söker $env:PSModulePath efter modulerna 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.
| Typ: | String[] |
| Position: | 0 |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | True |
-PassThru
Returnerar ett objekt som representerar det objekt som du arbetar med. Som standard genererar den här cmdleten inga utdata.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-Proxy
Anger en proxyserver för begäran i stället för att ansluta direkt till en Internetresurs.
| Typ: | Uri |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
-ProxyCredential
Anger ett användarkonto som har behörighet att använda proxyservern som anges av parametern Proxy.
| Typ: | PSCredential |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
-RequiredVersion
Anger den exakta version som den befintliga installerade modulen ska uppdateras till. Den version som anges av RequiredVersion måste finnas i onlinegalleriet eller så visas ett fel. Om fler än en modul uppdateras i ett enda kommando kan du inte använda RequiredVersion.
| Typ: | String |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
-Scope
Anger modulens installationsomfång. De godtagbara 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-versionerna 2.0.0 och senare är standardvärdet CurrentUser, som inte kräver utökade installationer.
- I PowerShellGet 1.x-versioner är standardvärdet AllUsers, som kräver utökade installationer.
| Typ: | String |
| Godkända värden: | CurrentUser, AllUsers |
| Position: | Named |
| Standardvärde: | CurrentUser |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-WhatIf
Visar vad som skulle hända om Update-Module körs. Cmdleten körs inte.
| Typ: | SwitchParameter |
| Alias: | wi |
| Position: | Named |
| Standardvärde: | False |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
Indata
String[]
Utdata
Kommentarer
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 Allaanvändare, $env:ProgramFiles\PowerShell\Modules, behöver utökade behörigheter.
Update-Module körs på PowerShell 3.0 eller senare versioner av PowerShell, på Windows 7 eller Windows 2008 R2 och senare versioner av Windows.
Om den modul som du anger med parametern Name inte installerades med hjälp av Install-Moduleuppstå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 returnerar Update-Module ett fel som identifierar problemprocesserna. Användaren informeras om att försöka Update-Module igen när processerna har stoppats.