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[]
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.
Comentários
https://aka.ms/ContentUserFeedback.
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja:Submeter e ver comentários