Save-Package
Salva pacotes no computador local sem instalá-los.
Sintaxe
PackageBySearch
Save-Package
[-Name] <String[]>
[-RequiredVersion <String>]
[-MinimumVersion <String>]
[-MaximumVersion <String>]
[-Source <String[]>]
[-Path <String>]
[-LiteralPath <String>]
[-Credential <PSCredential>]
[-Proxy <Uri>]
[-ProxyCredential <PSCredential>]
[-AllVersions]
[-Force]
[-ForceBootstrap]
[-WhatIf]
[-Confirm]
[-ProviderName <String[]>]
[<CommonParameters>]
Save-Package
-InputObject <SoftwareIdentity>
[-Path <String>]
[-LiteralPath <String>]
[-Credential <PSCredential>]
[-Proxy <Uri>]
[-ProxyCredential <PSCredential>]
[-AllVersions]
[-Force]
[-ForceBootstrap]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Save-Package
[-Path <String>]
[-LiteralPath <String>]
[-Credential <PSCredential>]
[-Proxy <Uri>]
[-ProxyCredential <PSCredential>]
[-AllVersions]
[-Force]
[-ForceBootstrap]
[-WhatIf]
[-Confirm]
[-ConfigFile <String>]
[-SkipValidate]
[-Headers <String[]>]
[-FilterOnTag <String[]>]
[-Contains <String>]
[-AllowPrereleaseVersions]
[<CommonParameters>]
NuGet
Save-Package
[-Path <String>]
[-LiteralPath <String>]
[-Credential <PSCredential>]
[-Proxy <Uri>]
[-ProxyCredential <PSCredential>]
[-AllVersions]
[-Force]
[-ForceBootstrap]
[-WhatIf]
[-Confirm]
[-ConfigFile <String>]
[-SkipValidate]
[-Headers <String[]>]
[-FilterOnTag <String[]>]
[-Contains <String>]
[-AllowPrereleaseVersions]
[<CommonParameters>]
Save-Package
[-Path <String>]
[-LiteralPath <String>]
[-Credential <PSCredential>]
[-Proxy <Uri>]
[-ProxyCredential <PSCredential>]
[-AllVersions]
[-Force]
[-ForceBootstrap]
[-WhatIf]
[-Confirm]
[-AllowPrereleaseVersions]
[-PackageManagementProvider <String>]
[-PublishLocation <String>]
[-ScriptSourceLocation <String>]
[-ScriptPublishLocation <String>]
[-Type <String>]
[-Filter <String>]
[-Tag <String[]>]
[-Includes <String[]>]
[-DscResource <String[]>]
[-RoleCapability <String[]>]
[-Command <String[]>]
[-AcceptLicense]
[<CommonParameters>]
PowerShellGet
Save-Package
[-Path <String>]
[-LiteralPath <String>]
[-Credential <PSCredential>]
[-Proxy <Uri>]
[-ProxyCredential <PSCredential>]
[-AllVersions]
[-Force]
[-ForceBootstrap]
[-WhatIf]
[-Confirm]
[-AllowPrereleaseVersions]
[-PackageManagementProvider <String>]
[-PublishLocation <String>]
[-ScriptSourceLocation <String>]
[-ScriptPublishLocation <String>]
[-Type <String>]
[-Filter <String>]
[-Tag <String[]>]
[-Includes <String[]>]
[-DscResource <String[]>]
[-RoleCapability <String[]>]
[-Command <String[]>]
[-AcceptLicense]
[<CommonParameters>]
Description
O cmdlet Save-Package salva pacotes no computador local, mas não instala os pacotes.
Este cmdlet salva a versão mais recente de um pacote, a menos que você especifique um RequiredVerion . Os parâmetros Path e LiteralPath são mutuamente exclusivos e não podem ser adicionados ao mesmo comando.
Exemplos
Exemplo 1: Salvar um pacote no computador local
Este exemplo salva a versão mais recente do pacote em um diretório no computador local. As dependências do pacote são baixadas com o pacote.
PS> Save-Package -Name NuGet.Core -ProviderName NuGet -Path C:\LocalPkg
Name Version Source Summary
---- ------- ------ -------
Microsoft.Web.Xdt 3.0.0 Nuget Microsoft Xml Document Transformation (XDT) enables...
NuGet.Core 2.14.0 Nuget NuGet.Core is the core framework assembly for NuGet...
Save-Package usa o parâmetro Name para especificar o pacote. O pacote é baixado do repositório especificado pelo parâmetro ProviderName . O parâmetro Path determina onde o pacote é salvo.
Exemplo 2: Salvar uma versão específica do pacote
Este exemplo especifica a versão do pacote e a salva em um diretório no computador local.
PS> Save-Package -Name NuGet.Core -RequiredVersion 2.9.0 -ProviderName NuGet -Path C:\LocalPkg
Name Version Source Summary
---- ------- ------ -------
Microsoft.Web.Xdt 3.0.0 Nuget Microsoft Xml Document Transformation (XDT) enables...
NuGet.Core 2.9.0 Nuget NuGet.Core is the core framework assembly for NuGet...
Save-Package usa o parâmetro Name para especificar o pacote.
RequiredVersion indica uma versão específica do pacote. O pacote é baixado do repositório especificado pelo parâmetro ProviderName . O parâmetro Path determina onde o pacote é salvo.
Exemplo 3: Usar Find-Package para salvar um pacote
Este comando usa Find-Package para localizar a versão mais recente do pacote e envia o objeto para Save-Package.
PS> Find-Package -Name NuGet.Core -ProviderName NuGet | Save-Package -Path C:\LocalPkg
Find-Package usa o parâmetro Name para especificar o pacote. O pacote é baixado do repositório especificado pelo parâmetro ProviderName . O objeto é enviado pelo pipeline para Save-Package. O parâmetro Path determina onde o pacote é salvo.
Exemplo 4: Salvar e instalar o pacote
A versão mais recente do pacote e suas dependências são baixadas e instaladas no computador local.
PS> Save-Package -Name NuGet.Core -ProviderName NuGet -Path C:\LocalPkg
PS> Install-Package C:\LocalPkg\NuGet.Core.2.14.0.nupkg
Save-Package baixa o arquivo de pacote e suas dependências para o computador local.
Install-Package instala o pacote e as dependências a partir do diretório especificado.
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
PowerShellGet:PackageByInputObject
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
PowerShellGet
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-AllowPrereleaseVersions
Permite que pacotes marcados como pré-lançamento sejam salvos.
Propriedades dos parâmetros
Tipo: SwitchParameter
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
NuGet:PackageByInputObject
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
NuGet
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
PowerShellGet:PackageByInputObject
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
PowerShellGet
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-AllVersions
Indica que esse cmdlet salva todas as versões disponíveis do pacote.
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
-Command
Especifica um ou mais comandos incluídos no pacote.
Propriedades dos parâmetros
Tipo: String [ ]
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
PowerShellGet:PackageByInputObject
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
PowerShellGet
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-ConfigFile
Especifica um arquivo de configuração.
Propriedades dos parâmetros
Tipo: String
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
NuGet:PackageByInputObject
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
NuGet
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 o cmdlet.
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
-Contains
Save-Package Obtém objetos se qualquer item nos valores de propriedade do objeto for uma correspondência exata para o valor especificado.
Propriedades dos parâmetros
Tipo: String
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
NuGet:PackageByInputObject
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
NuGet
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 salvar um pacote de um provedor ou fonte de pacotes especificado.
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: False Valor dos restantes argumentos: False
-DscResource
Especifica um ou mais recursos de Configuração de Estado Desejado (DSC) para o pacote.
Propriedades dos parâmetros
Tipo: String [ ]
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
PowerShellGet:PackageByInputObject
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
PowerShellGet
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-Filter
Especifica um filtro para o pacote.
Propriedades dos parâmetros
Tipo: String
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
PowerShellGet:PackageByInputObject
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
PowerShellGet
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-FilterOnTag
Especifica a tag que filtra os resultados. Os resultados que não contêm a tag especificada são excluídos.
Propriedades dos parâmetros
Tipo: String [ ]
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
NuGet:PackageByInputObject
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
NuGet
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-Force
Força o comando a ser executado sem pedir a confirmação do usuário.
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
-ForceBootstrap
Indica que Save-Package força PackageManagement a instalar automaticamente o provedor de pacotes para o pacote especificado.
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
Especifica os cabeçalhos para o pacote.
Tipo: String [ ]
Default value: None Suporta carateres universais: False NãoMostrar: False
NuGet:PackageByInputObject
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
NuGet
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-Includes
Indica os recursos que o pacote inclui.
Propriedades dos parâmetros
Tipo: String [ ]
Default value: None Valores aceites: DscResource, Cmdlet, Function, Workflow, RoleCapability Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
PowerShellGet:PackageByInputObject
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
PowerShellGet
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
Um objeto de ID de software que representa o pacote que você deseja salvar. As IDs de software fazem parte dos resultados do cmdlet Find-Package.
Tipo: Microsoft.PackageManagement.Packaging.SoftwareIdentity
Default value: None Suporta carateres universais: False NãoMostrar: False
PackageByInputObject
Position: Named Obrigatório: True Valor do pipeline: True Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-LiteralPath
Especifica o caminho literal no qual você deseja salvar o pacote. Não é possível adicionar esse parâmetro e o parâmetro Path ao 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: False Valor dos restantes argumentos: False
-MaximumVersion
Especifica a versão máxima do pacote que você deseja salvar.
Propriedades dos parâmetros
Tipo: String
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
PackageBySearch
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-MinimumVersion
Especifica a versão mínima do pacote que você deseja localizar.
Propriedades dos parâmetros
Tipo: String
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
PackageBySearch
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-Name
Especifica um ou mais nomes de pacote.
Propriedades dos parâmetros
Tipo: String [ ]
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
PackageBySearch
Position: 0 Obrigatório: True Valor do pipeline: False Valor do pipeline por nome de propriedade: True Valor dos restantes argumentos: False
-PackageManagementProvider
Especifica um provedor de gerenciamento de pacotes.
Propriedades dos parâmetros
Tipo: String
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
PowerShellGet:PackageByInputObject
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
PowerShellGet
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-Path
Especifica o local no computador local para armazenar o pacote.
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: False Valor dos restantes argumentos: False
-ProviderName
Especifica um ou mais nomes de provedores.
Propriedades dos parâmetros
Tipo: String [ ]
Default value: None Valores aceites: Bootstrap, NuGet, PowerShellGet Suporta carateres universais: False NãoMostrar: False Aliases: Fornecedor
Conjuntos de parâmetros
PackageBySearch
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: True Valor dos restantes argumentos: False
-Proxy
Especifica um servidor proxy para a solicitação, em vez de uma conexão direta com o 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: False 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: False Valor dos restantes argumentos: False
-PublishLocation
Especifica o local de publicação.
Propriedades dos parâmetros
Tipo: String
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
PowerShellGet:PackageByInputObject
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
PowerShellGet
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-RequiredVersion
Especifica a versão exata do pacote a ser salvo.
Propriedades dos parâmetros
Tipo: String
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
PackageBySearch
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-RoleCapability
Especifica uma matriz de recursos de função.
Propriedades dos parâmetros
Tipo: String [ ]
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
PowerShellGet:PackageByInputObject
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
PowerShellGet
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-ScriptPublishLocation
Especifica o local de publicação do script.
Propriedades dos parâmetros
Tipo: String
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
PowerShellGet:PackageByInputObject
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
PowerShellGet
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-ScriptSourceLocation
Especifica o local de origem do script.
Propriedades dos parâmetros
Tipo: String
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
PowerShellGet:PackageByInputObject
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
PowerShellGet
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-SkipValidate
Opção que ignora a validação das credenciais de um pacote.
Propriedades dos parâmetros
Tipo: SwitchParameter
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
NuGet:PackageByInputObject
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
NuGet
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-Source
Especifica uma ou mais fontes de pacote.
Propriedades dos parâmetros
Tipo: String [ ]
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
PackageBySearch
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: True Valor dos restantes argumentos: False
-Tag
Especifica uma tag para pesquisar nos metadados do pacote.
Propriedades dos parâmetros
Tipo: String [ ]
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
PowerShellGet:PackageByInputObject
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
PowerShellGet
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-Type
Especifica se os pacotes devem ser pesquisados com um módulo, um script ou ambos.
Propriedades dos parâmetros
Tipo: String
Default value: None Valores aceites: Module, Script, All Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
PowerShellGet:PackageByInputObject
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
PowerShellGet
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 o cmdlet fosse executado. 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 .
Microsoft.PackageManagement.Packaging.SoftwareIdentity
Você pode canalizar um objeto SoftwareIdentity para este cmdlet.
Saídas
None
Este cmdlet não retorna nenhuma saída.
Notas
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 no blog do PowerShell.
