Partilhar via

Uninstall-PSResource

  • Referência
Módulo:
Microsoft.PowerShell.PSResourceGet

Desinstala um recurso que foi instalado com o PowerShellGet.

Sintaxe

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

Este cmdlet combina a funcionalidade dos Uninstall-Module cmdlets e Uninstall-Script do PowerShellGet v2. O cmdlet procura nos caminhos de instalação do pacote recursos que tenham o ficheiro de metadados XML do PowerShellGet . Os recursos correspondentes são desinstalados do sistema.

Por predefinição, o cmdlet verifica se o recurso que está a ser 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õ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á estão instaladas:

  • 4.0.1-preview
  • 4.1.0
  • 4.0.2-preview

O Uninstall-PSResource cmdlet remove a versão estável e de pré-lançamento que se inserem no intervalo de versões especificado. De acordo com as regras nuGetVersion, uma versão de pré-lançamento é inferior a uma versão estável, pelo que a pré-visualização 4.0.1 é, na verdade, inferior à versão 4.0.1 no intervalo especificado. Por conseguinte, a pré-visualização 4.0.1 não é removida. 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-preview

Isto é o mesmo que o exemplo anterior, exceto o parâmetro Pré-lançamento 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 a sua confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-InputObject

Utilizado para entrada de pipeline.

Tipo:Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[]
Position:0
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Name

Nome de um recurso ou recursos a remover. Os carateres universais são suportados, mas o NuGet só aceita o * caráter.

Tipo:String[]
Position:0
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:True

-Prerelease

Indica que apenas os recursos da versão de pré-lançamento devem ser removidos.

Tipo:SwitchParameter
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Scope

Especifica o âmbito do recurso a desinstalar.

Tipo:Microsoft.PowerShell.PSResourceGet.UtilClasses.ScopeType
Valores aceites:CurrentUser, AllUsers
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-SkipDependencyCheck

Por predefinição, o cmdlet verifica se o recurso que está a ser removido é uma dependência para outro recurso. A utilização deste parâmetro ignora o teste de dependência.

Tipo:SwitchParameter
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Version

Especifica a versão do recurso a remover. O valor pode ser uma versão exata ou um intervalo de versões com a sintaxe de controlo de versões NuGet.

Para obter mais informações sobre os intervalos de versões do NuGet, veja Controlo de versões do pacote.

O PowerShellGet suporta todas as versões inclusivas mínimas listadas na documentação do intervalo de versões NuGet. Utilizar 1.0.0.0 como a versão não produz as versões 1.0.0.0 e superior (intervalo inclusivo mínimo). Em vez disso, o valor é considerado a versão necessária. Para procurar um intervalo inclusivo mínimo, utilize [1.0.0.0, ] como intervalo de versões.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:True

-WhatIf

Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

Entradas

String[]

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[]

Saídas

Object