Uninstall-PSResource
Desinstala um recurso que foi instalado usando o PowerShellGet.
Sintaxe
NameParameterSet (Predefinição)
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>]
Description
Este cmdlet combina a funcionalidade dos cmdlets Uninstall-Module e Uninstall-Script do PowerShellGet v2. O cmdlet pesquisa os caminhos de instalação do pacote em busca de recursos que tenham o PowerShellGet arquivo de metadados XML. Os recursos correspondentes são desinstalados do sistema.
Por padrão, o cmdlet verifica se o recurso que está sendo removido é uma dependência de 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ões 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á estejam instaladas:
- 4.0.1-Pré-visualização
- 4.1.0
- 4.0.2-Pré-visualização
O cmdlet Uninstall-PSResource remove as versões estável e de pré-lançamento que estão dentro do intervalo de versões especificado. De acordo com as regras do NuGetVersion, uma versão de pré-lançamento é menor do que uma versão estável, portanto, 4.0.1-preview é realmente menor do 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á estejam instaladas:
- 4.0.1-Pré-visualização
- 4.1.0
- 4.0.2-Pré-visualização
Isso é o mesmo que o exemplo anterior, exceto o parâmetro Prerelease significa que apenas as versões de pré-lançamento são removidas. Apenas 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 confirmação antes de executar o cmdlet.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | False |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | Cf. |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-InputObject
Usado para entrada de pipeline.
Propriedades dos parâmetros
| Tipo: | Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[] |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
InputObjectParameterSet
| Position: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Name
Nome de um recurso ou recursos a remover. Os curingas são suportados, mas o NuGet só aceita o caractere *.
Propriedades dos parâmetros
| Tipo: | String[] |
| Default value: | None |
| Suporta carateres universais: | True |
| NãoMostrar: | False |
Conjuntos de parâmetros
NameParameterSet
| Position: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Prerelease
Indica que apenas os recursos da versão de pré-lançamento devem ser removidos.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | False |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Scope
Especifica o escopo do recurso a ser desinstalado.
Propriedades dos parâmetros
| Tipo: | Microsoft.PowerShell.PSResourceGet.UtilClasses.ScopeType |
| Default value: | None |
| Valores aceites: | CurrentUser, AllUsers |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-SkipDependencyCheck
Por padrão, o cmdlet verifica se o recurso que está sendo removido é uma dependência de outro recurso. O uso desse parâmetro ignora o teste de dependência.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | False |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Version
Especifica a versão do recurso a ser removido. O valor pode ser uma versão exata ou um intervalo de versões usando a sintaxe de controle de versão do NuGet.
Para obter mais informações sobre intervalos de versões do NuGet, consulte Versionamento de pacotes.
O PowerShellGet suporta todas, exceto a versão mínima inclusiva listada na documentação do intervalo de versões do NuGet. Usar 1.0.0.0 como a versão não produz versões 1.0.0.0 e superiores (intervalo mínimo inclusivo). Em vez disso, o valor é considerado a versão necessária. Para procurar um intervalo mínimo inclusivo, use [1.0.0.0, ] como o intervalo de versões.
Propriedades dos parâmetros
| Tipo: | String |
| Default value: | None |
| Suporta carateres universais: | True |
| NãoMostrar: | False |
Conjuntos de parâmetros
NameParameterSet
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | False |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | Wi |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.
Entradas
String
Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo
Saídas
Object
Notas
O módulo define usres como um alias para Uninstall-PSResource.
