Update-PSResource baixa e instala a versão mais recente de um pacote já instalado na máquina local. Este cmdlet substitui os cmdlets Update-Module e Update-Script do PowerShellGet v2. A nova versão do recurso é instalada lado a lado com as versões anteriores em uma nova pasta versionada.
Por padrão, o Update-PSResource instala a versão mais recente do pacote e qualquer uma de suas dependências sem excluir as versões mais antigas instaladas. Não há nenhum comando para desinstalar versões mais antigas de um pacote. Você deve excluir manualmente os arquivos e pastas das versões mais antigas.
Update-PSResource não carrega o módulo atualizado na sessão atual. Você deve importar a nova versão ou iniciar uma nova sessão para usar o módulo atualizado. Para obter mais informações, consulte Import-Module.
Exemplos
Exemplo 1
Neste exemplo, o usuário já tem o pacote TestModule instalado e atualiza o pacote.
Get-PSResource -Name "TestModule"
Name Version Prerelease Description
---- ------- ---------- -----------
TestModule 1.2.0 test
Update-PSResource -Name "TestModule"
Name Version Prerelease Description
---- ------- ---------- -----------
TestModule 1.3.0 test
TestModule 1.2.0 test
Parâmetros
-AcceptLicense
Para recursos que exigem uma licença, AcceptLicense aceita automaticamente o contrato de licença durante a atualização.
Especifica o nome de um ou mais recursos a serem atualizados. Os curingas são suportados, mas o NuGet só aceita o caractere *. O NuGet não suporta pesquisas curinga de repositórios locais (baseados em arquivos).
Especifica um ou mais nomes de repositório para pesquisar. Se não for especificado, a pesquisa inclui todos os repositórios registrados, em ordem de prioridade (mais alta primeiro), até que seja encontrado um repositório que contenha o pacote. Os repositórios são classificados por prioridade e, em seguida, por nome. Valores de de prioridade de mais baixos têm uma precedência maior.
Ao pesquisar recursos em vários repositórios, os cmdlets PSResourceGet pesquisam os repositórios usando essa ordem de classificação.
Update-PSResource atualiza o primeiro pacote correspondente da lista classificada de repositórios.
O parâmetro suporta o caractere curinga *. Se você especificar vários repositórios, todos os nomes deverão incluir ou omitir o caractere curinga. Não é possível especificar uma combinação de nomes com e sem curingas.
Especifica o caminho para instalar temporariamente o recurso antes da instalação real. Se nenhum caminho temporário for fornecido, o recurso será instalado temporariamente na pasta temporária do usuário atual.
Especifica a versão do recurso a ser retornado. 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.
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.
A fonte deste conteúdo pode ser encontrada no GitHub, onde também pode criar e rever issues e pull requests. Para mais informações, consulte o nosso guia para colaboradores.