Partilhar via


Save-PSResource

Guarda recursos (módulos e scripts) de um repositório registado no computador.

Syntax

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

Description

Este cmdlet combina a funcionalidade dos Save-Module cmdlets e Save-Script do PowerShellGet v2. Save-PSResource transfere um recurso de um repositório registado para um caminho específico no computador local. Por predefinição, o recurso é guardado no formato desembalado ou instalado. Os scripts ou módulos podem ser executados a partir da localização guardada. Existe também uma opção para transferir o recurso em .nupkg formato.

Exemplos

Exemplo 1

Transfere o módulo Az do repositório de prioridade mais alta e guarda-o na localização atual.

Save-PSResource -Name Az

Exemplo 2

Transfere o módulo Az do Galeria do PowerShell e guarda-o na localização atual.

Save-PSResource -Name Az -Repository PSGallery

Exemplo 3

Transfere o módulo Az do repositório de prioridade mais alta e guarda-o em .nupkg formato para a localização atual.

Save-PSResource Az -AsNupkg

Exemplo 4

Transfere o módulo Az a partir do repositório de prioridade mais alta e inclui o ficheiro de metadados XML do PowerShellGet .

Save-PSResource Az -IncludeXML

Parâmetros

-AsNupkg

Guarda o recurso como um .nupkg ficheiro.

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

-AuthenticodeCheck

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

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

-Confirm

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

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

-Credential

Credenciais opcionais utilizadas ao aceder a um repositório.

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

-IncludeXml

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

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

-InputObject

Utilizado para entrada de pipeline.

Type:Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[]
Aliases:ParentResource
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

O nome de um ou mais recursos a instalar.

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

-PassThru

Quando especificado, produz um objeto PSResourceInfo para o recurso guardado.

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

-Path

Especifica o caminho para guardar o recurso. Se não for fornecido nenhum caminho, o recurso será guardado no diretório atual.

Type:String
Position:Named
Default value:current directory
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Prerelease

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

Type:SwitchParameter
Aliases:IsPrerelease
Position:Named
Default value:False
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Repository

Especifica um ou mais nomes de repositórios a procurar. Se não for especificado, a pesquisa inclui todos os repositórios registados, por ordem de prioridade (primeiro mais alto), até ser encontrado um repositório que contenha o pacote. Os repositórios são ordenados por prioridade e, em seguida, pelo nome. Os valores de Prioridade Inferior têm uma precedência superior.

Ao procurar recursos em vários repositórios, os cmdlets PSResourceGet pesquisam os repositórios com esta sequência de ordenação. Save-PSResource guarda o primeiro pacote correspondente na lista ordenada de repositórios.

O parâmetro suporta o * caráter universal. Se especificar vários repositórios, todos os nomes têm de incluir ou omitir o caráter universal. Não pode especificar uma combinação de nomes com e sem carateres universais.

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

-SkipDependencyCheck

Ignora a verificação de dependências de recursos. Só são instalados recursos encontrados. Não são instalados recursos do recurso encontrado.

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

-TemporaryPath

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

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

-TrustRepository

Suprima pedidos para confiar no repositório. O pedido para confiar no repositório só ocorre se o repositório não estiver configurado como fidedigno.

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

-Version

Especifica a versão do recurso a devolver. O valor pode ser uma versão exata ou um intervalo de versões com a sintaxe de controlo de versões NuGet.

Para obter mais informações sobre os intervalos de versões do NuGet, veja Controlo de versões do pacote.

O PowerShellGet suporta todas as versões inclusivas mínimas listadas na documentação do intervalo de versões NuGet. Utilizar 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 procurar um intervalo inclusivo mínimo, utilize [1.0.0.0, ] como intervalo de versões.

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

-WhatIf

Apresenta o que aconteceria mediante a execução do cmdlet. 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

SwitchParameter

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[]

Saídas

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo

Por predefinição, o cmdlet não devolve objetos. Quando o parâmetro PassThru é utilizado, o cmdlet produz um objeto PSResourceInfo para o recurso guardado.