Update-Script

  • Referência
Módulo:
PowerShellGet

Atualizações um script.

Syntax

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

Description

O Update-Script cmdlet atualiza um script instalado no computador local. O script atualizado é baixado do mesmo repositório que a versão instalada.

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 o script especificado

Este exemplo atualiza um script instalado e exibe a versão atualizada.

Update-Script -Name UpdateManagement-Template -RequiredVersion 1.1
Get-InstalledScript -Name UpdateManagement-Template

Version   Name                       Repository   Description
-------   ----                       ----------   -----------
1.1       UpdateManagement-Template  PSGallery    This is a template script for Update Management...

Update-Script usa o parâmetro Name para especificar o script a ser atualizado. O parâmetro RequiredVersion especifica a versão do script. Get-InstalledScript exibe a versão atualizada do script.

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 script com o script mais recente marcado como 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-Script.

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 script.

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

-Force

Força Update-Script a execução sem solicitar a confirmação do usuário.

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 um nome de script ou uma matriz de nomes de script a serem atualizados.

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

-PassThru

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

-Proxy

O cmdlet 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 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

-WhatIf

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

Uri

PSCredential

Saídas

Object

Observações

O Galeria do PowerShell não dá mais suporte às versões 1.0 e 1.1 do Protocolo TLS.0 e 1.1. 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