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 Update-Module cmdlet 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
Position:Named
valore predefinito:False
Necessario:False
Accept pipeline input:False
Accept wildcard characters:False

-AuthenticodeCheck

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

Tipo:SwitchParameter
Position:Named
valore predefinito:False
Necessario:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Aliases:cf
Position:Named
valore predefinito:False
Necessario:False
Accept pipeline input:False
Accept wildcard characters:False

-Credential

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

Tipo:PSCredential
Position:Named
valore predefinito:None
Necessario:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

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

Tipo:SwitchParameter
Position:Named
valore predefinito:False
Necessario:False
Accept pipeline input:False
Accept wildcard characters: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[]
Position:0
valore predefinito:"*"
Necessario:False
Accept pipeline input:True
Accept wildcard characters:True

-PassThru

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

Tipo:SwitchParameter
Position:Named
valore predefinito:False
Necessario:False
Accept pipeline input:False
Accept wildcard characters:False

-Prerelease

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

Tipo:SwitchParameter
Position:Named
valore predefinito:False
Necessario:False
Accept pipeline input:False
Accept wildcard characters:False

-Quiet

Elimina le informazioni sullo stato di avanzamento.

Tipo:SwitchParameter
Position:Named
valore predefinito:False
Necessario:False
Accept pipeline input:False
Accept wildcard characters: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 Priorità inferiore hanno una precedenza più alta.

Quando si cercano risorse in più repository, i cmdlet 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[]
Position:Named
valore predefinito:None
Necessario:False
Accept pipeline input:False
Accept wildcard characters: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
Position:Named
valore predefinito:None
Necessario:False
Accept pipeline input:False
Accept wildcard characters:False

-SkipDependencyCheck

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

Tipo:SwitchParameter
Position:Named
valore predefinito:False
Necessario:False
Accept pipeline input:False
Accept wildcard characters: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
Position:Named
valore predefinito:None
Necessario:False
Accept pipeline input:False
Accept wildcard characters: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
Position:Named
valore predefinito:False
Necessario:False
Accept pipeline input:False
Accept wildcard characters: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, ma la versione minima inclusa elencata nella documentazione relativa all'intervallo di versioni di NuGet. L'uso 1.0.0.0 come versione non produce 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
Position:Named
valore predefinito:None
Necessario:False
Accept pipeline input:False
Accept wildcard characters:True

-WhatIf

Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.

Tipo:SwitchParameter
Aliases:wi
Position:Named
valore predefinito:False
Necessario:False
Accept pipeline input:False
Accept wildcard characters: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.