Condividi tramite

Update-PSResource

  • Riferimento
Modulo:
Microsoft.PowerShell.PSResourceGet

Scarica e installa la versione più recente di un pacchetto già installato nel computer locale.

Sintassi

Update-PSResource
      [[-Name] <String[]>]
      [-Version <String>]
      [-Prerelease]
      [-Repository <String[]>]
      [-Scope <ScopeType>]
      [-TemporaryPath <String>]
      [-TrustRepository]
      [-Credential <PSCredential>]
      [-Quiet]
      [-AcceptLicense]
      [-Force]
      [-PassThru]
      [-SkipDependencyCheck]
      [-AuthenticodeCheck]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Descrizione

Update-PSResource scarica e installa la versione più recente di un pacchetto già installato nel computer locale. Questo cmdlet sostituisce i cmdlet Update-Module e Update-Script da PowerShellGet v2. La nuova versione della risorsa viene installata side-by-side con le versioni precedenti in una nuova cartella con controllo delle versioni.

Per impostazione predefinita, Update-PSResource installa la versione più recente del pacchetto e le relative dipendenze senza eliminare le versioni precedenti installate. Non è disponibile alcun comando per disinstallare le versioni precedenti di un pacchetto. È necessario eliminare manualmente i file e le cartelle delle versioni precedenti.

Update-PSResource non carica il modulo aggiornato nella sessione corrente. È necessario importare la nuova versione o avviare una nuova sessione per usare il modulo aggiornato. Per altre informazioni, vedere Import-Module.

Esempio

Esempio 1

In questo esempio l'utente ha già installato il pacchetto TestModule e aggiorna il pacchetto.

Get-PSResource -Name "TestModule"

Name                                    Version                         Prerelease   Description
----                                    -------                         ----------   -----------
TestModule                              1.2.0                                        test

Update-PSResource -Name "TestModule"

Name                                    Version                         Prerelease   Description
----                                    -------                         ----------   -----------
TestModule                              1.3.0                                        test
TestModule                              1.2.0                                        test

Parametri

-AcceptLicense

Per le risorse che richiedono una licenza, AcceptLicense accetta automaticamente il contratto di licenza durante l'aggiornamento.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-AuthenticodeCheck

Convalida i file firmati e i file di catalogo in Windows.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Credential

Specifica le credenziali facoltative usate per l'accesso a un repository privato.

Tipo:PSCredential
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Force

Se specificato, ignora i controlli per TrustRepository e AcceptLicense e aggiorna il pacchetto.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Name

Specifica il nome di una o più risorse da aggiornare. I caratteri jolly sono supportati, ma NuGet accetta solo il carattere *. NuGet non supporta le ricerche con caratteri jolly dei repository locali (basati su file).

Tipo:String[]
Posizione:0
Valore predefinito:"*"
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:True

-PassThru

Se specificato, restituisce un oggetto PSResourceInfo per la risorsa salvata.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Prerelease

Se specificato, consente l'aggiornamento a una versione non definitiva.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Quiet

Elimina le informazioni sullo stato di avanzamento.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Repository

Specifica uno o più nomi di repository da cercare. Se non specificato, la ricerca include tutti i repository registrati, in ordine di priorità (il primo), fino a quando non viene trovato un repository che contiene il pacchetto. I repository vengono ordinati in base alla priorità e quindi in base al nome. I valori Priority lower hanno una precedenza più alta.

Quando si cercano risorse in più repository, i cmdlet di PSResourceGet eseguono ricerche nei repository usando questo ordinamento. Update-PSResource aggiorna il primo pacchetto corrispondente dall'elenco ordinato di repository.

Il parametro supporta il carattere jolly *. Se si specificano più repository, tutti i nomi devono includere o omettere il carattere jolly. Non è possibile specificare una combinazione di nomi con e senza caratteri jolly.

Tipo:String[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:True

-Scope

Specifica l'ambito di installazione. I valori accettati sono:

  • CurrentUser
  • AllUsers

L'ambito predefinito è CurrentUser, che non richiede l'elevazione dei privilegi.

Tipo:Microsoft.PowerShell.PSResourceGet.UtilClasses.ScopeType
Valori accettati:CurrentUser, AllUsers
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-SkipDependencyCheck

Ignora il controllo delle dipendenze delle risorse. Ciò significa che vengono aggiornate solo le risorse denominate.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-TemporaryPath

Specifica il percorso per installare temporaneamente la risorsa prima dell'installazione effettiva. Se non viene specificato alcun percorso temporaneo, la risorsa viene installata temporaneamente nella cartella temporanea dell'utente corrente.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-TrustRepository

Elimina le richieste di attendibilità del repository. Il prompt per considerare attendibile il repository si verifica solo se il repository non è configurato come attendibile.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Version

Specifica la versione della risorsa da restituire. Il valore può essere una versione esatta o un intervallo di versioni usando la sintassi di controllo delle versioni di NuGet.

Per altre informazioni sugli intervalli di versioni di NuGet, vedere Controllo delle versioni dei pacchetti.

PowerShellGet supporta tutte le versioni incluse elencate nella documentazione dell'intervallo di versioni di NuGet. L'uso di 1.0.0.0 perché la versione non restituisce versioni 1.0.0.0 e successive (intervallo inclusivo minimo). Il valore viene invece considerato la versione richiesta. Per cercare un intervallo inclusivo minimo, usare [1.0.0.0, ] come intervallo di versioni.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:True

-WhatIf

Mostra cosa accadrebbe se il cmdlet viene eseguito. Il cmdlet non viene eseguito.

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

String[]

Output

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo

Per impostazione predefinita, il cmdlet non restituisce oggetti. Quando si usa il parametro PassThru, il cmdlet restituisce un oggetto PSResourceInfo per la risorsa salvata.

Note

Il modulo definisce udres come alias per Update-PSResource.