Uninstall-PSResource
Disinstalla una risorsa installata usando PowerShellGet.
Sintassi
NameParameterSet (Impostazione predefinita)
Uninstall-PSResource
[-Name] <String[]>
[-Version <String>]
[-Prerelease]
[-SkipDependencyCheck]
[-Scope <ScopeType>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
InputObjectParameterSet
Uninstall-PSResource
[-InputObject] <PSResourceInfo[]>
[-Prerelease]
[-SkipDependencyCheck]
[-Scope <ScopeType>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Descrizione
Questo cmdlet combina la funzionalità dei cmdlet Uninstall-Module e Uninstall-Script da PowerShellGet v2. Il cmdlet cerca i percorsi di installazione del pacchetto per le risorse con PowerShellGet file di metadati XML. Le risorse corrispondenti vengono disinstallate dal sistema.
Per impostazione predefinita, il cmdlet verifica se la risorsa da rimuovere è 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 versioni specificato.
Uninstall-PSResource -name Az -version "(5.0.0, 7.5.0)"
Esempio 4
In questo esempio si presuppone che siano già installate le versioni seguenti di modulo Az:
- 4.0.1-preview
- 4.1.0
- 4.0.2-preview
Il cmdlet Uninstall-PSResource rimuove la versione stabile e non definitiva che rientra nell'intervallo di versioni specificato. Per le regole NuGetVersion, una versione non definitiva è inferiore a una versione stabile, quindi la versione 4.0.1-preview è effettivamente inferiore alla versione 4.0.1 nell'intervallo specificato. Pertanto, la versione 4.0.1-preview non viene rimossa. 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 siano già installate le versioni seguenti di modulo Az:
- 4.0.1-preview
- 4.1.0
- 4.0.2-preview
Questo è lo stesso dell'esempio precedente, ad eccezione del parametro versione preliminare 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 non definitiva.
Uninstall-PSResource -name Az -version "[4.0.1, 4.1.0]" -Prerelease
Parametri
-Confirm
Richiede conferma prima di eseguire il cmdlet.
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 |
-InputObject
Usato per l'input della pipeline.
Proprietà dei parametri
| Tipo: | Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[] |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
InputObjectParameterSet
| Posizione: | 0 |
| Obbligatorio: | True |
| Valore dalla pipeline: | True |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Name
Nome di una risorsa o di una risorsa da rimuovere. I caratteri jolly sono supportati, ma NuGet accetta solo il carattere *.
Proprietà dei parametri
| Tipo: | String[] |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | True |
| DontShow: | False |
Set di parametri
NameParameterSet
| Posizione: | 0 |
| Obbligatorio: | True |
| Valore dalla pipeline: | True |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Prerelease
Indica che devono essere rimosse solo le risorse della versione non definitiva.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | False |
| 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 |
-Scope
Specifica l'ambito della risorsa da disinstallare.
Proprietà dei parametri
| Tipo: | Microsoft.PowerShell.PSResourceGet.UtilClasses.ScopeType |
| Valore predefinito: | None |
| Valori accettati: | CurrentUser, AllUsers |
| 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 |
-SkipDependencyCheck
Per impostazione predefinita, il cmdlet verifica se la risorsa da rimuovere è una dipendenza per un'altra risorsa. L'uso di questo parametro ignora il test delle dipendenze.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | False |
| 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 |
-Version
Specifica la versione della risorsa da rimuovere. 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.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | True |
| DontShow: | False |
Set di parametri
NameParameterSet
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-WhatIf
Mostra gli effetti dell'esecuzione del cmdlet. 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.
Input
String
Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo
Output
Object
Note
Il modulo definisce usres come un alias per Uninstall-PSResource.
