Partilhar via

Update-PSResource

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

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
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-AuthenticodeCheck

Valida arquivos assinados e arquivos de catálogo no Windows.

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

-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

-Credential

Especifica credenciais opcionais usadas ao acessar um repositório privado.

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

-Force

Quando especificado, ignora as verificações para TrustRepository e AcceptLicense e atualiza o pacote.

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

-Name

Especifica o nome de um ou mais recursos a serem atualizados. 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).

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

-PassThru

Quando especificado, gera uma saída de um objeto PSResourceInfo para o recurso salvo.

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

-Prerelease

Quando especificado, permite a atualização para uma versão de pré-lançamento.

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

-Quiet

Suprime informações de progresso.

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

-Repository

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. Os valores de Prioridade Inferior têm uma precedência mais elevada.

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.

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

-Scope

Especifica o escopo da instalação. Os valores aceites são:

  • CurrentUser
  • AllUsers

O escopo padrão é CurrentUser, que não requer elevação.

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

Ignora a verificação de dependências de recursos. Isso significa que apenas os recursos nomeados são atualizados.

Tipo:SwitchParameter
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-TrustRepository

Suprimir 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
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 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 Controle de versão 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 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[]

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.

Notas

O módulo define udres como um alias para Update-PSResource.