Update-Module
Scarica e installa la versione più recente dei moduli specificati da una raccolta online nel computer locale.
Sintassi
All
Update-Module
[[-Name] <String[]>]
[-RequiredVersion <Version>]
[-MaximumVersion <Version>]
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Descrizione
Il Update-Module cmdlet installa la versione più recente di un modulo da una raccolta online. Viene richiesto di confermare l'aggiornamento prima dell'installazione. Gli aggiornamenti vengono installati solo per i moduli installati nel computer locale con Install-Module.
Update-Module cerca $env:PSModulePath i moduli installati.
Update-Module senza parametri specificati, vengono aggiornati tutti i moduli installati. Per specificare un modulo da aggiornare, usare il parametro Name . È possibile eseguire l'aggiornamento alla versione specifica di un modulo utilizzando il parametro RequiredVersion .
Se un modulo installato è già la versione più recente, il modulo non viene aggiornato. Se il modulo non viene trovato in $env:PSModulePath, viene visualizzato un errore.
Per visualizzare i moduli installati, usare Get-InstalledModule.
Esempio
Esempio 1: Aggiornare tutti i moduli
Questo esempio aggiorna tutti i moduli installati alla versione più recente in una raccolta online.
Update-Module
Esempio 2: Aggiornare un modulo in base al nome
Questo esempio aggiorna un modulo specifico alla versione più recente in una raccolta online.
Update-Module -Name SpeculationControl
Update-Module usa il parametro Name per aggiornare un modulo specifico, SpeculationControl.
Esempio 3: Visualizzare le esecuzioni di Update-Module di simulazione
Questo esempio esegue uno scenario di simulazione per mostrare cosa accade se Update-Module viene eseguito. Il comando non viene eseguito.
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 usa il parametro WhatIf per visualizzare cosa accadrebbe se Update-Module fosse stato eseguito.
Esempio 4: Aggiornare un modulo a una versione specificata
In questo esempio un modulo viene aggiornato a una versione specifica. La versione deve esistere nella raccolta online o viene visualizzato un errore.
Update-Module -Name SpeculationControl -RequiredVersion 1.0.14
Update-Module usa il parametro Name per specificare il modulo , SpeculationControl. Il parametro RequiredVersion specifica la versione 1.0.14.
Esempio 5: Aggiornare un modulo senza conferma
Questo esempio non richiede la conferma per aggiornare il modulo alla versione più recente da una raccolta online. Se il modulo è già installato, il parametro Force reinstalla il modulo.
Update-Module -Name SpeculationControl -Force
Update-Module usa il parametro Name per specificare il modulo , SpeculationControl. Il parametro Force aggiorna il modulo senza richiedere la conferma dell'utente.
Parametri
-Confirm
Richiede conferma prima di eseguire Update-Module.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | False |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | cfr |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Force
Forza un aggiornamento di ogni modulo specificato senza una richiesta di conferma. Se il modulo è già installato, Force reinstalla il modulo.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-MaximumVersion
Specifica la versione massima di un singolo modulo da aggiornare. Non è possibile aggiungere questo parametro se si sta tentando di aggiornare più moduli. I parametri MaximumVersion e RequiredVersion non possono essere usati nello stesso comando.
Proprietà dei parametri
| Tipo: | Version |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
-Name
Specifica i nomi di uno o più moduli da aggiornare.
Update-Module cerca $env:PSModulePath i moduli da aggiornare. Se non vengono trovate $env:PSModulePath corrispondenze per il nome del modulo specificato, si verifica un errore.
I caratteri jolly vengono accettati nei nomi dei moduli. Se si aggiungono caratteri jolly al nome specificato e non vengono trovate corrispondenze, non si verifica alcun errore.
Proprietà dei parametri
| Tipo: | String[] |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | True |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | 0 |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
-RequiredVersion
Specifica la versione esatta in cui verrà aggiornato il modulo installato esistente. La versione specificata da RequiredVersion deve esistere nella raccolta online oppure viene visualizzato un errore. Se più moduli vengono aggiornati in un singolo comando, non è possibile usare RequiredVersion.
Proprietà dei parametri
| Tipo: | Version |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
-WhatIf
Mostra cosa accadrebbe se Update-Module venisse eseguito. Il cmdlet non viene eseguito.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | False |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | Wi |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
CommonParameters
Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.
Note
Per PowerShell 5.1 o versione successiva, l'ambito predefinito in una sessione con privilegi elevati è AllUsers e in una sessione non con privilegi elevati CurrentUser. Gli aggiornamenti dei moduli per AllUsers, $env:ProgramFiles\PowerShell\Modules, necessitano di autorizzazioni elevate. Gli aggiornamenti dei moduli per CurrentUser, $home\Documents\PowerShell\Modules, non richiedono autorizzazioni elevate.
Update-Module viene eseguito in PowerShell 3.0 o versioni successive di PowerShell, in Windows 7 o Windows 2008 R2 e versioni successive di Windows.
Se il modulo specificato con il parametro Name non è stato installato utilizzando Install-Module, si verifica un errore.
È possibile eseguire Update-Module solo nei moduli installati dalla raccolta online eseguendo Install-Module.
Se Update-Module tenta di aggiornare i file binari in uso, Update-Module restituisce un errore che identifica i processi di problema. L'utente viene informato di riprovare Update-Module dopo l'arresto dei processi.