Update-Module

  • Referência
Módulo:
PowerShellGet

Baixa e instala a versão mais recente dos módulos especificados de uma galeria online para o computador local.

Syntax

Update-Module
      [[-Name] <String[]>]
      [-RequiredVersion <String>]
      [-MaximumVersion <String>]
      [-Credential <PSCredential>]
      [-Scope <String>]
      [-Proxy <Uri>]
      [-ProxyCredential <PSCredential>]
      [-Force]
      [-AllowPrerelease]
      [-AcceptLicense]
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

O Update-Module cmdlet instala a versão mais recente de um módulo de uma galeria online. Você será solicitado a confirmar a atualização antes que ela seja instalada. Atualizações são instalados apenas para módulos que foram instalados no computador local com Install-Module. Update-Module pesquisa $env:PSModulePath módulos instalados.

Este é um cmdlet proxy para o Update-PSResource cmdlet no Microsoft.PowerShell.PSResourceGet. Para obter mais informações, consulte Update-PSResource.

Exemplos

Exemplo 1: Atualizar todos os módulos

Este exemplo atualiza todos os módulos instalados para a versão mais recente em uma galeria online.

Update-Module

Exemplo 2: Atualizar um módulo por nome

Este exemplo atualiza um módulo específico para a versão mais recente em uma galeria online.

Update-Module -Name SpeculationControl

Update-Module usa o parâmetro Name para atualizar um módulo específico, SpeculationControl.

Exemplo 3: Exibir execuções de teste de hipóteses Update-Module

Este exemplo faz um cenário de teste de hipóteses para mostrar o que acontece se Update-Module for executado. O comando não é executado.

Update-Module -WhatIf

What if: Performing the operation "Update-Module" on target "Version '2.8.0' of module
  'Carbon', updating to version '2.8.1'".
What if: Performing the operation "Update-Module" on target "Version '1.0.10' of module
  'SpeculationControl', updating to version '1.0.14'".

Update-Module usa o parâmetro WhatIf para exibir o que aconteceria se Update-Module fosse executado.

Exemplo 4: atualizar um módulo para uma versão especificada

Neste exemplo, um módulo é atualizado para uma versão específica. A versão deve existir na galeria online ou um erro é exibido.

Update-Module -Name SpeculationControl -RequiredVersion 1.0.14

Update-Module usa o parâmetro Name para especificar o módulo SpeculationControl. O parâmetro RequiredVersion especifica a versão 1.0.14.

Exemplo 5: Atualizar um módulo sem confirmação

Este exemplo não solicita confirmação para atualizar o módulo para a versão mais recente de uma galeria online. Se o módulo já estiver instalado, o parâmetro Force reinstalará o módulo.

Update-Module -Name SpeculationControl -Force

Update-Module usa o parâmetro Name para especificar o módulo SpeculationControl. O parâmetro Force atualiza o módulo sem solicitar a confirmação do usuário.

Parâmetros

-AcceptLicense

Aceite automaticamente o contrato de licença durante a instalação se o pacote exigir.

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

-AllowPrerelease

Permite que você atualize um módulo com o módulo mais recente marcado como um pré-lançamento.

O cmdlet proxy mapeia esse parâmetro para o parâmetro Prerelease de Update-PSResource.

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

-Confirm

Solicita a confirmação antes de executar Update-Module.

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

-Credential

Especifica uma conta de usuário que tem permissão para atualizar um módulo.

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

-Force

Força uma atualização de cada módulo especificado sem um prompt para solicitar confirmação. Se o módulo já estiver instalado, Forçar reinstalará o módulo.

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

-MaximumVersion

O cmdlet proxy usa o valor desse parâmetro para criar uma cadeia de caracteres de pesquisa de versão do NuGet para uso com o parâmetro Version de Update-PSResource.

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

-Name

Especifica os nomes de um ou mais módulos a serem atualizados. Update-Module pesquisa $env:PSModulePath os módulos a serem atualizados. Se nenhuma correspondência for encontrada no $env:PSModulePath para o nome do módulo especificado, ocorrerá um erro.

Curingas são aceitos em nomes de módulo. Se você adicionar caracteres curinga ao nome especificado e nenhuma correspondência for encontrada, nenhum erro ocorrerá.

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

-PassThru

Retorna um objeto que representa o item com que você está trabalhando. Por padrão, este cmdlet não gera saída.

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

-Proxy

O cmdlet de proxy ignora esse parâmetro, pois ele não tem suporte pelo Update-PSResource.

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

-ProxyCredential

O cmdlet de proxy ignora esse parâmetro, pois ele não tem suporte pelo Update-PSResource.

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

-RequiredVersion

O cmdlet proxy usa o valor desse parâmetro para criar uma cadeia de caracteres de pesquisa de versão do NuGet para uso com o parâmetro Version de Update-PSResource.

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

-Scope

Especifica o escopo de instalação do módulo. Os valores aceitáveis para esse parâmetro são AllUsers e CurrentUser. Se Scope não for especificado, a atualização será instalada no escopo CurrentUser .

O escopo AllUsers requer permissões elevadas e instala módulos em um local acessível a todos os usuários do computador:

$env:ProgramFiles\PowerShell\Modules

O CurrentUser não requer permissões elevadas e instala módulos em um local acessível somente ao usuário atual do computador:

$HOME\Documents\PowerShell\Modules

Quando nenhum Escopo é definido, o padrão é definido com base na versão do PowerShellGet.

  • No PowerShellGet versões 2.0.0 e superiores, o padrão é CurrentUser, que não requer elevação para instalação.
  • Nas versões do PowerShellGet 1.x, o padrão é AllUsers, que requer elevação para instalação.
Type:String
Accepted values:CurrentUser, AllUsers
Position:Named
Default value:CurrentUser
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Mostra o que aconteceria se Update-Module 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[]

String

PSCredential

Uri

Saídas

Object

Observações

O PowerShell inclui os seguintes aliases para Update-Module:

  • Todas as plataformas:
    • upmo

Para o PowerShell versão 6.0 e superior, o escopo de instalação padrão é sempre CurrentUser. As atualizações de módulo para CurrentUser, $HOME\Documents\PowerShell\Modules, não precisam de permissões elevadas. As atualizações de módulo para AllUsers, $env:ProgramFiles\PowerShell\Modules, precisam de permissões elevadas.

O Galeria do PowerShell não dá mais suporte às versões 1.0 e 1.1 do protocolo TLS. Você deve usar o TLS 1.2 ou superior. Use o seguinte comando para garantir que esteja usando o TLS 1.2:

[Net.ServicePointManager]::SecurityProtocol = [Net.ServicePointManager]::SecurityProtocol -bor [Net.SecurityProtocolType]::Tls12

Update-Module é executado no PowerShell 3.0 ou versões posteriores do PowerShell, no Windows 7 ou windows 2008 R2 e versões posteriores do Windows.

Se o módulo que você especificar com o parâmetro Name não tiver sido instalado usando Install-Module, ocorrerá um erro.

Você só pode executar Update-Module em módulos instalados por meio da galeria online executando Install-Module.

Se Update-Module tentar atualizar binários que estão em uso, Update-Module retornará um erro que identifica os processos de problema. O usuário é informado para tentar novamente Update-Module depois que os processos forem interrompidos.