Compartilhar via

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.

Sintaxe

Update-Module
      [[-Name] <String[]>]
      [-RequiredVersion <Version>]
      [-MaximumVersion <Version>]
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

O cmdlet Update-Module 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. As atualizações são instaladas apenas para módulos que foram instalados no computador local com Install-Module. Update-Module pesquisa $env:PSModulePath módulos instalados.

Update-Module sem parâmetros especificados atualiza todos os módulos instalados. Para especificar um módulo a ser atualizado, use o parâmetro Name. Você pode atualizar para a versão específica de um módulo usando o parâmetro RequiredVersion.

Se um módulo instalado já for a versão mais recente, o módulo não será atualizado. Se o módulo não for encontrado em $env:PSModulePath, um erro será exibido.

Para exibir os módulos instalados, use Get-InstalledModule.

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 Update-Module de hipóteses

Este exemplo faz um cenário 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 exibir o que aconteceria se Update-Module fossem executados.

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 reinstala 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

-Confirm

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

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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, Force reinstala o módulo.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-MaximumVersion

Especifica a versão máxima de um único módulo a ser atualizado. Você não poderá adicionar esse parâmetro se estiver tentando atualizar vários módulos. O MaximumVersion e os parâmetros RequiredVersion não podem ser usados no mesmo comando.

Tipo:Version
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga: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 em $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á.

Tipo:String[]
Cargo:0
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:True

-RequiredVersion

Especifica a versão exata para a qual o módulo instalado existente será atualizado. A versão especificada pelo RequiredVersion deve existir na galeria online ou um erro é exibido. Se mais de um módulo for atualizado em um único comando, você não poderá usar RequiredVersion.

Tipo:Version
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-WhatIf

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

Observações

Para o PowerShell 5.1 ou inferior, o escopo padrão em uma sessão com privilégios elevados é allUserse, em uma sessão não elevada, CurrentUser. As atualizações de módulo para allUsers, $env:ProgramFiles\PowerShell\Modules, precisam de permissões elevadas. As atualizações de módulo para CurrentUser, $home\Documents\PowerShell\Modules, não precisam de permissões elevadas.

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 especificado com o Name parâmetro não tiver sido instalado usando Install-Module, ocorrerá um erro.

Você só pode executar Update-Module em módulos instalados na 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.