Uninstall-PSResource

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

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

Object