Condividi tramite

Uninstall-PSResource

  • Riferimento
Modulo:
Microsoft.PowerShell.PSResourceGet

Disinstalla una risorsa installata con PowerShellGet.

Sintassi

Uninstall-PSResource
         [-Name] <String[]>
         [-Version <String>]
         [-Prerelease]
         [-SkipDependencyCheck]
         [-Scope <ScopeType>]
         [-WhatIf]
         [-Confirm]
         [<CommonParameters>]
Uninstall-PSResource
         [-Prerelease]
         [-InputObject] <PSResourceInfo[]>
         [-SkipDependencyCheck]
         [-Scope <ScopeType>]
         [-WhatIf]
         [-Confirm]
         [<CommonParameters>]

Descrizione

Questo cmdlet combina la funzionalità dei Uninstall-Module cmdlet e Uninstall-Script da PowerShellGet v2. Il cmdlet cerca i percorsi di installazione del pacchetto per le risorse con il file di metadati XML PowerShellGet . Le risorse corrispondenti vengono disinstallate dal sistema.

Per impostazione predefinita, il cmdlet verifica se la risorsa rimossa è una dipendenza per un'altra risorsa.

Esempio

Esempio 1

Disinstallare la versione più recente del modulo Az .

Uninstall-PSResource Az

Esempio 2

Disinstallare una versione specifica del modulo Az .

Uninstall-PSResource -name Az -version "5.0.0"

Esempio 3

Disinstalla tutte le versioni del modulo Az all'interno dell'intervallo di versione specificato.

Uninstall-PSResource -name Az -version "(5.0.0, 7.5.0)"

Esempio 4

In questo esempio si presuppone che le versioni seguenti del modulo Az siano già installate:

  • 4.0.1-Preview
  • 4.1.0
  • 4.0.2-preview

Il Uninstall-PSResource cmdlet rimuove la versione stabile e preliminare che rientrano nell'intervallo di versioni specificato. Per le regole NuGetVersion, una versione preliminare è minore di una versione stabile, quindi 4.0.1-preview è effettivamente minore della versione 4.0.1 nell'intervallo specificato. Pertanto, 4.0.1-preview non viene rimosso. Le versioni 4.1.0 e 4.0.2-preview vengono rimosse perché rientrano nell'intervallo.

Uninstall-PSResource -name Az -version "[4.0.1, 4.1.0]"

Esempio 5

In questo esempio si presuppone che le versioni seguenti del modulo Az siano già installate:

  • 4.0.1-Preview
  • 4.1.0
  • 4.0.2-preview

Questo è lo stesso dell'esempio precedente, ad eccezione del parametro Prerelease , significa che vengono rimosse solo le versioni non definitive. Solo la versione 4.0.2-preview viene rimossa perché la versione 4.0.1-preview non è compresa nell'intervallo e la versione 4.1.0 non è una versione preliminare.

Uninstall-PSResource -name Az -version "[4.0.1, 4.1.0]" -Prerelease

Parametri

-Confirm

Richiede la conferma dell'utente 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

-InputObject

Usato per l'input della pipeline.

Tipo:Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[]
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Name

Nome di una risorsa o di risorse da rimuovere. I caratteri jolly sono supportati, ma NuGet accetta solo il * carattere.

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

-Prerelease

Indica che devono essere rimosse solo le risorse della versione non definitiva.

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

-Scope

Specifica l'ambito della risorsa da disinstallare.

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

Per impostazione predefinita, il cmdlet verifica se la risorsa rimossa è una dipendenza per un'altra risorsa. L'uso di questo parametro ignora il test delle dipendenze.

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 rimuovere. Il valore può essere una versione esatta o un intervallo di versioni usando la sintassi del controllo delle versioni NuGet.

Per altre informazioni sugli intervalli di versioni NuGet, vedere Controllo delle versioni del pacchetto.

PowerShellGet supporta tutto ma la versione minima inclusiva elencata nella documentazione dell'intervallo di versioni NuGet. L'uso 1.0.0.0 come versione non restituisce versioni 1.0.0.0 e successive (intervallo minimo inclusivo). Il valore viene invece considerato come 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 l'esito in caso di esecuzione del cmdlet. 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[]

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[]

Output

Object