Dela via


Update-Module

Laddar ned och installerar den senaste versionen av angivna moduler från ett onlinegalleri till den lokala datorn.

Syntax

All

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.

Det här är en proxy-cmdlet för cmdleten Update-PSResource i Microsoft.PowerShell.PSResourceGet. Mer information finns i Update-PSResource.

Exempel

Exempel 1: Uppdatera alla moduler

I det här exemplet uppdateras alla installerade moduler till den senaste versionen i ett onlinegalleri.

Update-Module

Exempel 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.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument: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.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Confirm

Uppmanar dig att bekräfta innan du kör Update-Module.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:False
Stöder jokertecken:False
DontShow:False
Alias:jfr

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Credential

Anger ett användarkonto som har behörighet att uppdatera en modul.

Parameteregenskaper

Typ:PSCredential
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument: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.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument: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.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument: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.

Parameteregenskaper

Typ:

String[]

Standardvärde:None
Stöder jokertecken:True
DontShow:False

Parameteruppsättningar

(All)
Position:0
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-PassThru

Returnerar ett objekt som representerar det objekt som du arbetar med. Som standard genererar den här cmdleten inga utdata.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Proxy

Proxy-cmdleten ignorerar den här parametern eftersom den inte stöds av Update-PSResource.

Parameteregenskaper

Typ:Uri
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-ProxyCredential

Proxy-cmdleten ignorerar den här parametern eftersom den inte stöds av Update-PSResource.

Parameteregenskaper

Typ:PSCredential
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument: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.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-Scope

Anger modulens installationsomfång. De acceptabla värdena för den här parametern är AllUsers och CurrentUser. Om omfånget 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 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.

Parameteregenskaper

Typ:String
Standardvärde:CurrentUser
Godkända värden:CurrentUser, AllUsers
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-WhatIf

Visar vad som skulle hända om Update-Module kördes. Cmdleten körs inte.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:False
Stöder jokertecken:False
DontShow:False
Alias:Wi

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

CommonParameters

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

Indata

String

String

PSCredential

Uri

Utdata

Object

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 Allaanvändare, $env:ProgramFiles\PowerShell\Modules, behöver utökade behörigheter.

PowerShell-galleriet stöder inte längre TLS-versionerna (Transport Layer Security) 1.0 och 1.1. Du måste använda TLS 1.2 eller senare. Använd följande kommando för att se till 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, på Windows 7 eller Windows 2008 R2 och senare versioner av Windows.

Om den modul som du anger med parametern Namn inte har installerats med , 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.