Save-PSResource

Referência

Módulo:: Microsoft.PowerShell.PSResourceGet

Salva recursos (módulos e scripts) de um repositório registrado no computador.

Sintaxe

Save-PSResource
    [-Name] <String[]>
    [-Version <String>]
    [-Prerelease]
    [-Repository <String[]>]
    [-Credential <PSCredential>]
    [-IncludeXml]
    [-Path <String>]
    [-TemporaryPath <String>]
    [-TrustRepository]
    [-PassThru]
    [-SkipDependencyCheck]
    [-AuthenticodeCheck]
    [-Quiet]
    [-AcceptLicense]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Save-PSResource
    [-Name] <String[]>
    [-Version <String>]
    [-Prerelease]
    [-Repository <String[]>]
    [-Credential <PSCredential>]
    [-AsNupkg]
    [-Path <String>]
    [-TemporaryPath <String>]
    [-TrustRepository]
    [-PassThru]
    [-SkipDependencyCheck]
    [-AuthenticodeCheck]
    [-Quiet]
    [-AcceptLicense]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Save-PSResource
    [-Repository <String[]>]
    [-Credential <PSCredential>]
    [-AsNupkg]
    [-IncludeXml]
    [-Path <String>]
    [-TemporaryPath <String>]
    [-TrustRepository]
    [-PassThru]
    [-InputObject] <PSResourceInfo[]>
    [-SkipDependencyCheck]
    [-AuthenticodeCheck]
    [-Quiet]
    [-AcceptLicense]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Esse cmdlet combina a funcionalidade dos cmdlets Save-Module e Save-Script do PowerShellGet v2. Save-PSResource baixa um recurso de um repositório registrado para um caminho específico no computador local. Por padrão, o recurso é salvo no formato desempacotado ou instalado. Os scripts ou módulos podem ser executados no local salvo. Também há uma opção para baixar o recurso no formato .nupkg.

Exemplos

Exemplo 1

Baixa o módulo Az do repositório de prioridade mais alta e salva-o no local atual.

Save-PSResource -Name Az

Exemplo 2

Baixa o módulo Az da Galeria do PowerShell e o salva no local atual.

Save-PSResource -Name Az -Repository PSGallery

Exemplo 3

Baixa o módulo Az do repositório de prioridade mais alta e salva-o em .nupkg formato para o local atual.

Save-PSResource Az -AsNupkg

Exemplo 4

Baixa o módulo Az do repositório de prioridade mais alta e inclui o arquivo de metadados do PowerShellGet XML.

Save-PSResource Az -IncludeXML

Parâmetros

-AcceptLicense

Para módulos que exigem uma licença, aceita automaticamente o contrato de licença durante a instalação.

Esse parâmetro foi adicionado ao PSResourceGet 1.1.0-rc1.

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

-AsNupkg

Salva o recurso como um arquivo .nupkg.

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

-AuthenticodeCheck

Valida os arquivos assinados e os arquivos de catálogo do recurso no Windows.

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

-Confirm

Solicita a confirmação antes de executar o cmdlet.

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

-Credential

Credenciais opcionais usadas ao acessar um repositório.

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

-IncludeXml

Inclui o XML de metadados do PowerShellGet usado para verificar se o PowerShellGet instalou um módulo.

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

-InputObject

Usado para entrada de pipeline.

Tipo:	Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[]
Aliases:	ParentResource
Cargo:	0
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	True
Aceitar caracteres curinga:	False

-Name

O nome de um ou mais recursos a serem instalados.

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

-PassThru

Quando especificado, gera um objeto PSResourceInfo para o recurso salvo.

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

-Path

Especifica o caminho para o qual salvar o recurso. Se nenhum caminho for fornecido, o recurso será salvo no diretório atual.

Tipo:	String
Cargo:	Named
Valor padrão:	current directory
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-Prerelease

Quando especificado, inclui versões de pré-lançamento nos resultados da pesquisa retornados.

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

-Quiet

Suprime a saída da barra de progresso.

Esse parâmetro foi adicionado ao PSResourceGet 1.1.0-rc1.

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

-Repository

Especifica um ou mais nomes de repositório a serem pesquisados. Se não for especificado, a pesquisa inclui todos os repositórios registrados, em ordem de prioridade (primeiro mais alto), até que um repositório seja encontrado que contenha o pacote. Os repositórios são classificados por prioridade e, em seguida, por nome. Valores de de prioridade de inferiores têm uma precedência maior.

Ao pesquisar recursos em vários repositórios, os cmdlets de PSResourceGet pesquisam os repositórios usando essa ordem de classificação. Save-PSResource salva o primeiro pacote correspondente da lista classificada de repositórios.

O parâmetro dá suporte ao caractere curinga *. Se você especificar vários repositórios, todos os nomes deverão incluir ou omitir o caractere curinga. Você não pode especificar uma combinação de nomes com e sem curingas.

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

-SkipDependencyCheck

Ignora a verificação de dependências de recursos. Somente os recursos encontrados são instalados. Nenhum recurso encontrado está instalado.

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

-TemporaryPath

Especifica o caminho para instalar temporariamente o recurso antes de salvar. Se nenhum caminho temporário for fornecido, o recurso será temporariamente instalado na pasta temporária do usuário atual.

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

-TrustRepository

Suprimir solicitações para confiar no repositório. O prompt para confiar no repositório só ocorrerá se o repositório não estiver configurado como confiável.

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

-Version

Especifica a versão do recurso a ser retornado. O valor pode ser uma versão exata ou um intervalo de versão usando a sintaxe de controle de versão do NuGet.

Para obter mais informações sobre intervalos de versões do NuGet, consulte de controle de versão do pacote.

O PowerShellGet dá suporte a todas as versão inclusiva mínima listada na documentação do intervalo de versões do NuGet. Usar 1.0.0.0 como a versão não produz as versões 1.0.0.0 e superior (intervalo inclusivo mínimo). Em vez disso, o valor é considerado a versão necessária. Para pesquisar um intervalo inclusivo mínimo, use [1.0.0.0, ] como o intervalo de versão.

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

-WhatIf

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

Entradas

String[]

String

SwitchParameter

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[]

Saídas

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo

Por padrão, o cmdlet não retorna nenhum objeto. Quando o parâmetro PassThru é usado, o cmdlet gera um objeto PSResourceInfo para o recurso salvo.

Compartilhar via