Update-PSResource

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

Baixa e instala a versão mais recente de um pacote já instalado no computador local.

Syntax

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 no computador local. Esse cmdlet substitui os Update-Module cmdlets e Update-Script do PowerShellGet v2. A nova versão do recurso é instalada lado a lado com versões anteriores em uma nova pasta com controle de versão.

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.

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.

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AuthenticodeCheck

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

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-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

-Credential

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

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

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

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Especifica o nome de um ou mais recursos a serem atualizados. Há suporte para curingas, mas o NuGet aceita apenas o * caractere. O NuGet não dá suporte a pesquisas curinga de repositórios locais (baseados em arquivo).

Type:String[]
Position:0
Default value:"*"
Required:False
Accept pipeline input:True
Accept wildcard characters:True

-PassThru

Quando especificado, gera um objeto PSResourceInfo para o recurso salvo.

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Prerelease

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

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Quiet

Suprime as informações de progresso.

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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 (primeiro mais alto), até que um repositório seja encontrado que contenha o pacote. Os repositórios são classificados por prioridade e, em seguida, 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 dá suporte ao * caractere curinga. Se você especificar vários repositórios, todos os nomes deverão incluir ou omitir o caractere curinga. Você não pode especificar uma combinação de nomes com e sem curingas.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

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

Ignora o marcar para dependências de recursos. Isso significa que somente os recursos nomeados são atualizados.

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TrustRepository

Suprimir prompts para confiar no repositório. O prompt para confiar no repositório só ocorrerá se o repositório não estiver configurado como confiável.

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 retornado. 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[]

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.