Uninstall-PSResource
Desinstala um recurso que foi instalado usando o PowerShellGet.
Syntax
Uninstall-PSResource
[-Name] <String[]>
[-Version <String>]
[-Prerelease]
[-SkipDependencyCheck]
[-Scope <ScopeType>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Uninstall-PSResource
[-Prerelease]
[-InputObject] <PSResourceInfo[]>
[-SkipDependencyCheck]
[-Scope <ScopeType>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Esse cmdlet combina a funcionalidade dos Uninstall-Module
cmdlets e Uninstall-Script
do PowerShellGet v2. O cmdlet pesquisa os caminhos de instalação do pacote em busca de recursos que tenham o arquivo de metadados XML do PowerShellGet . Os recursos correspondentes são desinstalados do sistema.
Por padrão, o cmdlet verifica se o recurso que está sendo removido é uma dependência para outro recurso.
Exemplos
Exemplo 1
Desinstale a versão mais recente do módulo Az .
Uninstall-PSResource Az
Exemplo 2
Desinstale uma versão específica do módulo Az .
Uninstall-PSResource -name Az -version "5.0.0"
Exemplo 3
Desinstala todas as versões do módulo Az dentro do intervalo de versão especificado.
Uninstall-PSResource -name Az -version "(5.0.0, 7.5.0)"
Exemplo 4
Este exemplo pressupõe que as seguintes versões do módulo Az já estão instaladas:
- 4.0.1-preview
- 4.1.0
- 4.0.2-prévia
O Uninstall-PSResource
cmdlet remove a versão estável e de pré-lançamento que está dentro do intervalo de versão especificado. De acordo com as regras do NuGetVersion, uma versão de pré-lançamento é menor que uma versão estável, portanto, 4.0.1-preview é, na verdade, menor que a versão 4.0.1 no intervalo especificado. Portanto, 4.0.1-preview não é removido. As versões 4.1.0 e 4.0.2-preview são removidas porque estão dentro do intervalo.
Uninstall-PSResource -name Az -version "[4.0.1, 4.1.0]"
Exemplo 5
Este exemplo pressupõe que as seguintes versões do módulo Az já estão instaladas:
- 4.0.1-preview
- 4.1.0
- 4.0.2-prévia
Isso é o mesmo que o exemplo anterior, exceto que o parâmetro Prerelease significa que apenas as versões de pré-lançamento são removidas. Somente a versão 4.0.2-preview é removida porque a versão 4.0.1-preview está fora do intervalo e a versão 4.1.0 não é uma versão de pré-lançamento.
Uninstall-PSResource -name Az -version "[4.0.1, 4.1.0]" -Prerelease
Parâmetros
-Confirm
Solicita sua confirmação antes de executar o cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
Usado para entrada de pipeline.
Type: | Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Nome de um recurso ou recursos a serem removidos. Há suporte para curingas, mas o NuGet aceita apenas o *
caractere.
Type: | String[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | True |
-Prerelease
Indica que somente os recursos de versão de pré-lançamento devem ser removidos.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Scope
Especifica o escopo do recurso a ser desinstalado.
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
Por padrão, o cmdlet verifica se o recurso que está sendo removido é uma dependência para outro recurso. O uso desse parâmetro ignora o teste de dependência.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Version
Especifica a versão do recurso a ser removido. O valor pode ser uma versão exata ou um intervalo de versão usando a sintaxe de controle de versão do NuGet.
Para obter mais informações sobre intervalos de versão do NuGet, consulte Controle de versão do pacote.
O PowerShellGet dá suporte a todas as versões inclusivas mínimas listadas na documentação do intervalo de versões do NuGet. Usar 1.0.0.0
como a versão não gera versões 1.0.0.0 e superiores (intervalo inclusivo mínimo). Em vez disso, o valor é considerado a versão necessária. Para pesquisar um intervalo inclusivo mínimo, use [1.0.0.0, ]
como o intervalo de versão.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
String[]
Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[]
Saídas
Links Relacionados
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de