Uninstall-Module
Disinstalla un modulo.
Sintassi
NameParameterSet (Impostazione predefinita)
Uninstall-Module
[-Name] <String[]>
[-MinimumVersion <String>]
[-RequiredVersion <String>]
[-MaximumVersion <String>]
[-AllVersions]
[-Force]
[-AllowPrerelease]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
InputObject
Uninstall-Module
[-InputObject] <PSObject[]>
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Descrizione
Il Uninstall-Module cmdlet disinstalla un modulo specificato dal computer locale. Non è possibile disinstallare un modulo se altri moduli dipendono da esso o se il modulo non è stato installato con il Install-Module cmdlet .
È possibile eliminare manualmente i file di modulo, ma in questo modo è possibile interrompere tutti i moduli che dipendono dal modulo eliminato.
I parametri che accettano numeri di versione del modulo prevedono stringhe formattate come numeri di versione.
- I numeri di versione standard hanno un formato in
x.y.zcui x, y e z sono numeri - Le versioni non definitive hanno un formato in
x.y.z-<prerelease_label>cui la<prerelease_label>stringa è arbitraria assegnata a tale versione.
Esempio
Esempio 1: Disinstallare un modulo
In questo esempio viene disinstallato un modulo.
Uninstall-Module -Name SpeculationControl
Uninstall-Module utilizza il parametro Name per specificare il modulo da disinstallare dal computer locale.
Esempio 2: Usare la pipeline per disinstallare un modulo
In questo esempio la pipeline viene usata per disinstallare un modulo.
Get-InstalledModule -Name SpeculationControl | Uninstall-Module
Get-InstalledModule usa il parametro Name per specificare il modulo. L'oggetto viene inviato alla pipeline a Uninstall-Module e viene disinstallato.
Parametri
-AllowPrerelease
Consente di disinstallare un modulo contrassegnato come versione preliminare.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| 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 |
-AllVersions
Specifica che si desidera includere tutte le versioni disponibili di un modulo. Non è possibile usare il parametro AllVersions con i parametri MinimumVersion, MaximumVersion o RequiredVersion .
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| 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 |
-Confirm
Richiede conferma prima di eseguire il Uninstall-Module.
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 |
-Force
Forza Uninstall-Module l'esecuzione senza chiedere conferma dell'utente.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| 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 |
-InputObject
Accetta un oggetto PSRepositoryItemInfo . Ad esempio, restituire Get-InstalledModule una variabile e usare tale variabile come argomento InputObject .
Proprietà dei parametri
| Tipo: | PSObject[] |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
InputObject
| Posizione: | 0 |
| Obbligatorio: | True |
| Valore dalla pipeline: | True |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
-MaximumVersion
Specifica la versione massima, o più recente, del modulo da disinstallare. I parametri MaximumVersion e RequiredVersion non possono essere usati nello stesso comando.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
NameParameterSet
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
-MinimumVersion
Specifica la versione minima del modulo da disinstallare. I parametri MinimumVersion e RequiredVersion non possono essere usati nello stesso comando.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
NameParameterSet
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
-Name
Specifica una matrice di nomi di modulo da disinstallare.
Proprietà dei parametri
| Tipo: | String[] |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
NameParameterSet
| Posizione: | 0 |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
-RequiredVersion
Specifica il numero di versione esatto del modulo da disinstallare.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
NameParameterSet
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
-WhatIf
Mostra cosa accadrebbe se Uninstall-Module venisse eseguito. 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.