Update-PSResource
Baixa e instala a versão mais recente de um pacote já instalado na máquina local.
Sintaxe
Update-PSResource
[[-Name] <String[]>]
[-Version <String>]
[-Prerelease]
[-Repository <String[]>]
[-Scope <ScopeType>]
[-TemporaryPath <String>]
[-TrustRepository]
[-Credential <PSCredential>]
[-Quiet]
[-AcceptLicense]
[-Force]
[-PassThru]
[-SkipDependencyCheck]
[-AuthenticodeCheck]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Update-PSResource
Baixa e instala a versão mais recente de um pacote já instalado na máquina local. Este cmdlet substitui os Update-Module
cmdlets 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, 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.
Tipo: | SwitchParameter |
Cargo: | Named |
Valor padrão: | False |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-AuthenticodeCheck
Valida arquivos assinados e arquivos de catálogo no Windows.
Tipo: | SwitchParameter |
Cargo: | Named |
Valor padrão: | False |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-Confirm
Solicita sua confirmação antes de executar o cmdlet.
Tipo: | SwitchParameter |
Aliases: | cf |
Cargo: | Named |
Valor padrão: | False |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-Credential
Especifica credenciais opcionais usadas ao acessar um repositório privado.
Tipo: | PSCredential |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-Force
Quando especificado, ignora as verificações de TrustRepository e AcceptLicense e atualiza o pacote.
Tipo: | SwitchParameter |
Cargo: | Named |
Valor padrão: | False |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-Name
Especifica o nome de um ou mais recursos a serem atualizados. Há suporte para curingas, mas o NuGet só aceita o *
personagem. O NuGet não oferece suporte a pesquisas curinga de repositórios locais (baseados em arquivo).
Tipo: | String[] |
Cargo: | 0 |
Valor padrão: | "*" |
Obrigatório: | False |
Aceitar a entrada de pipeline: | True |
Aceitar caracteres curinga: | True |
-PassThru
Quando especificado, gera um objeto PSResourceInfo para o recurso salvo.
Tipo: | SwitchParameter |
Cargo: | Named |
Valor padrão: | False |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-Prerelease
Quando especificado, permite a atualização para uma versão de pré-lançamento.
Tipo: | SwitchParameter |
Cargo: | Named |
Valor padrão: | False |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-Quiet
Suprime informações de progresso.
Tipo: | SwitchParameter |
Cargo: | Named |
Valor padrão: | False |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-Repository
Especifica um ou mais nomes de repositório a serem pesquisados. Se não for especificado, a pesquisa incluirá 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 depois por nome. Os valores de Prioridade mais baixa têm uma precedência mais alta.
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 oferece suporte ao 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 mistura de nomes com e sem curingas.
Tipo: | String[] |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | True |
-Scope
Especifica o escopo de instalação. Os valores aceitos são:
CurrentUser
AllUsers
O escopo padrão é CurrentUser
, que não requer elevação.
Tipo: | Microsoft.PowerShell.PSResourceGet.UtilClasses.ScopeType |
Valores aceitos: | CurrentUser, AllUsers |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-SkipDependencyCheck
Ignora a verificação de dependências de recursos. Isso significa que apenas os recursos nomeados são atualizados.
Tipo: | SwitchParameter |
Cargo: | Named |
Valor padrão: | False |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-TemporaryPath
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.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-TrustRepository
Suprima prompts para confiar no repositório. O prompt para confiar no repositório só ocorre se o repositório não estiver configurado como confiável.
Tipo: | SwitchParameter |
Cargo: | Named |
Valor padrão: | False |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-Version
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 NuGet.
Para obter mais informações sobre intervalos de versão do NuGet, consulte Controle de versão de pacotes.
O PowerShellGet oferece suporte a todas, exceto a versão inclusiva mínima listada na documentação do intervalo de versões do NuGet. Usando 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ão.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | True |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Tipo: | SwitchParameter |
Aliases: | wi |
Cargo: | Named |
Valor padrão: | False |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
Entradas
String[]
Saídas
Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo
Por padrão, o cmdlet não retorna nenhum objeto. Quando o parâmetro PassThru é usado, o cmdlet gera um objeto PSResourceInfo para o recurso salvo.
Observações
O módulo define udres
como um alias para Update-PSResource
.