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.

Update-Module utan angivna parametrar uppdaterar alla installerade moduler. Om du vill ange en modul som ska uppdateras använder du parametern Namn . 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

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

Type:SwitchParameter
Position:Named
Default value:None
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
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
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
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Position:Named
Default value:None
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
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
Accept pipeline input:False
Accept wildcard characters:False

-Proxy

Anger en proxyserver för begäran i stället för att ansluta direkt till en Internetresurs.

Type:Uri
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-ProxyCredential

Anger ett användarkonto som har behörighet att använda proxyservern som anges av proxyparametern.

Type:PSCredential
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters: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.

Type:String
Position:Named
Default value:None
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
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
Accept pipeline input:False
Accept wildcard characters:False

Indata

String[]

String

PSCredential

Uri

Utdata

Object

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

Viktigt

Från och med april 2020 stöder PowerShell-galleriet inte längre TLS-versionerna 1.0 och 1.1. Om du inte använder TLS 1.2 eller senare får du ett felmeddelande när du försöker komma åt PowerShell-galleriet. Använd följande kommando för att kontrollera att du använder TLS 1.2:

[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12

Mer information finns i tillkännagivandet i PowerShell-bloggen.

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 hjälp Install-Moduleav inträffar 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.