Update-Module
Baixa e instala a versão mais recente dos módulos especificados de uma galeria online para o computador local.
Sintaxe
All
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 cmdlet Update-Module instala a versão mais recente de um módulo a partir 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 .
Os parâmetros que usam números de versão do módulo esperam cadeias de caracteres formatadas como números de versão.
- Os números de versão padrão têm um formato em
x.y.zque x, y e z são números - As versões de pré-lançamento têm um formato em que a
x.y.z-<prerelease_label>cadeia de<prerelease_label>caracteres é arbitrária atribuída a essa versão.
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 no $env:PSModulePath, será exibido um erro.
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: Ver Update-Module hipotéticos é executado
Este exemplo faz um cenário hipotético 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 WhatIf 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 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 o exigir.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-AllowPrerelease
Permite atualizar um módulo com o módulo mais recente marcado como pré-lançamento.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Confirm
Solicita confirmação antes de executar Update-Module.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | False |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | Cf. |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Credential
Especifica uma conta de usuário que tem permissão para atualizar um módulo.
Propriedades dos parâmetros
| Tipo: | PSCredential |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | 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.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-MaximumVersion
Especifica a versão máxima de um único módulo a ser atualizado. Não é possível adicionar esse parâmetro se estiver tentando atualizar vários módulos. Os parâmetros MaximumVersion e RequiredVersion não podem ser usados no mesmo comando.
Propriedades dos parâmetros
| Tipo: | String |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | 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 não forem encontradas correspondências no $env:PSModulePath para o nome do módulo especificado, ocorrerá um erro.
Curingas são aceitos em nomes de módulos. Se você adicionar caracteres curinga ao nome especificado e nenhuma correspondência for encontrada, nenhum erro ocorrerá.
Propriedades dos parâmetros
| Tipo: | String[] |
| Default value: | None |
| Suporta carateres universais: | True |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | 0 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
-PassThru
Retorna um objeto que representa o item com o qual você está trabalhando. Por padrão, esse cmdlet não gera nenhuma saída.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Proxy
Especifica um servidor proxy para a solicitação, em vez de se conectar diretamente a um recurso da Internet.
Propriedades dos parâmetros
| Tipo: | Uri |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
-ProxyCredential
Especifica uma conta de usuário que tem permissão para usar o servidor proxy especificado pelo parâmetro Proxy.
Propriedades dos parâmetros
| Tipo: | PSCredential |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
-RequiredVersion
Especifica a versão exata para a qual o módulo instalado existente será atualizado. A versão especificada por 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.
Propriedades dos parâmetros
| Tipo: | String |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
-Scope
Especifica o escopo de instalação do módulo. Os valores aceitáveis para este parâmetro são AllUsers e CurrentUser. Se Escopo 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 apenas ao usuário atual do computador:
$HOME\Documents\PowerShell\Modules
Quando nenhum Escopo é definido, o padrão é definido com base na versão 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.
Propriedades dos parâmetros
| Tipo: | String |
| Default value: | CurrentUser |
| Valores aceites: | CurrentUser, AllUsers |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-WhatIf
Mostra o que aconteceria se Update-Module corresse. O cmdlet não é executado.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | False |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | Wi |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.
Entradas
String
String
PSCredential
Uri
Saídas
Object
Notas
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.
Importante
A partir de abril de 2020, a Galeria do PowerShell não suporta mais as versões 1.0 e 1.1 do Transport Layer Security (TLS). Se você não estiver usando o TLS 1.2 ou superior, receberá um erro ao tentar acessar a Galeria do PowerShell. Use o seguinte comando para garantir que você esteja usando o TLS 1.2:
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
Para obter mais informações, consulte o de anúncio de
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 parâmetro Name não tiver sido instalado usando Install-Moduleo , ocorrerá um erro.
Você só pode executar Update-Module em módulos instalados a partir 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 problemáticos. O usuário é informado para tentar novamente Update-Module depois que os processos são interrompidos.
