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.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Usato per l'input della pipeline.

Type:Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

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

Type:String[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:True

-Prerelease

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

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Scope

Specifica l'ambito della risorsa da disinstallare.

Type:Microsoft.PowerShell.PSResourceGet.UtilClasses.ScopeType
Accepted values:CurrentUser, AllUsers
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

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

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

-WhatIf

Mostra l'esito in caso di esecuzione del cmdlet. Il cmdlet non viene eseguito.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Input

String[]

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[]

Output

Object