Update-PSResource

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

Transfere 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 transfere e instala a versão mais recente de um pacote já instalado no computador 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 versões anteriores numa nova pasta com versões novas.

Por predefinição, Update-PSResource instala a versão mais recente do pacote e qualquer uma das respetivas dependências sem eliminar as versões mais antigas instaladas.

Exemplos

Exemplo 1

Neste exemplo, o utilizador 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 requerem uma licença, 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 ficheiros assinados e ficheiros de catálogo no Windows.

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

-Confirm

Solicita a 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 utilizadas ao aceder a 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 atualizar. Os carateres universais são suportados, mas o NuGet só aceita o * caráter. O NuGet não suporta pesquisas universais de repositórios locais (baseados em ficheiros).

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

-PassThru

Quando especificado, produz um objeto PSResourceInfo para o recurso guardado.

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

-Prerelease

Quando especificado, permite atualizar 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órios a procurar. Se não for especificado, a pesquisa inclui todos os repositórios registados, por ordem de prioridade (primeiro mais alto), até ser encontrado um repositório que contenha o pacote. Os repositórios são ordenados por prioridade e, em seguida, pelo nome. Os valores de Prioridade Inferior têm uma precedência superior.

Ao procurar recursos em vários repositórios, os cmdlets PSResourceGet pesquisam os repositórios com esta sequência de ordenação. Update-PSResource atualiza o primeiro pacote correspondente a partir da lista ordenada de repositórios.

O parâmetro suporta o * caráter universal. Se especificar vários repositórios, todos os nomes têm de incluir ou omitir o caráter universal. Não pode especificar uma combinação de nomes com e sem carateres universais.

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

-Scope

Especifica o âmbito de instalação. Os valores aceites são:

  • CurrentUser
  • AllUsers

O âmbito predefinido é 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 a verificação de dependências de recursos. Isto significa que apenas 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 não for fornecido nenhum caminho temporário, o recurso será temporariamente instalado na pasta temporária do utilizador atual.

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

-TrustRepository

Suprima pedidos para confiar no repositório. O pedido para confiar no repositório só ocorre se o repositório não estiver configurado como fidedigno.

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 devolver. O valor pode ser uma versão exata ou um intervalo de versões com a sintaxe de controlo de versões NuGet.

Para obter mais informações sobre os intervalos de versões do NuGet, veja Controlo de versões do pacote.

O PowerShellGet suporta todas as versões inclusivas mínimas listadas na documentação do intervalo de versões NuGet. Utilizar 1.0.0.0 como a versão não produz as versões 1.0.0.0 e superior (intervalo inclusivo mínimo). Em vez disso, o valor é considerado a versão necessária. Para procurar um intervalo inclusivo mínimo, utilize [1.0.0.0, ] como intervalo de versões.

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

-WhatIf

Apresenta o que aconteceria mediante a execução do cmdlet. 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 predefinição, o cmdlet não devolve objetos. Quando o parâmetro PassThru é utilizado, o cmdlet produz um objeto PSResourceInfo para o recurso guardado.

Notas

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