Save-Module
Guarda um módulo e as respetivas dependências no computador local, mas não instala o módulo.
Syntax
Save-Module
[-Name] <String[]>
[-MinimumVersion <String>]
[-MaximumVersion <String>]
[-RequiredVersion <String>]
[-Repository <String[]>]
[-Path] <String>
[-Proxy <Uri>]
[-ProxyCredential <PSCredential>]
[-Credential <PSCredential>]
[-Force]
[-AllowPrerelease]
[-AcceptLicense]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Save-Module
[-Name] <String[]>
[-MinimumVersion <String>]
[-MaximumVersion <String>]
[-RequiredVersion <String>]
[-Repository <String[]>]
-LiteralPath <String>
[-Proxy <Uri>]
[-ProxyCredential <PSCredential>]
[-Credential <PSCredential>]
[-Force]
[-AllowPrerelease]
[-AcceptLicense]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Save-Module
[-InputObject] <PSObject[]>
-LiteralPath <String>
[-Proxy <Uri>]
[-ProxyCredential <PSCredential>]
[-Credential <PSCredential>]
[-Force]
[-AcceptLicense]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Save-Module
[-InputObject] <PSObject[]>
[-Path] <String>
[-Proxy <Uri>]
[-ProxyCredential <PSCredential>]
[-Credential <PSCredential>]
[-Force]
[-AcceptLicense]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Description
O Save-Module cmdlet transfere um módulo e quaisquer dependências de um repositório registado.
Save-Module transfere e guarda a versão mais atual de um módulo. Os ficheiros são guardados num caminho especificado no computador local. O módulo não está instalado, mas os conteúdos estão disponíveis para inspeção por um administrador. Em seguida, o módulo guardado pode ser copiado para a localização adequada $env:PSModulePath do computador offline.
Este é um cmdlet proxy para o Save-PSResource cmdlet no Microsoft.PowerShell.PSResourceGet. Para obter mais informações, veja Save-PSResource
Exemplos
Exemplo 1: Guardar um módulo
Neste exemplo, um módulo e as respetivas dependências são guardados no computador local.
Save-Module -Name PowerShellGet -Path C:\Test\Modules -Repository PSGallery
Get-ChildItem -Path C:\Test\Modules
Directory: C:\Test\Modules
Mode LastWriteTime Length Name
---- ------------- ------ ----
d----- 7/1/2019 13:31 PackageManagement
d----- 7/1/2019 13:31 PowerShellGetSave-Module utiliza o parâmetro Nome para especificar o módulo PowerShellGet. O parâmetro Caminho especifica onde armazenar o módulo transferido. O parâmetro Repositório especifica um repositório registado, PSGallery. Após a conclusão da transferência, Get-ChildItem apresenta o conteúdo do Caminho onde os ficheiros são armazenados.
Exemplo 2: Guardar uma versão específica de um módulo
Este exemplo mostra como utilizar um parâmetro como MaximumVersion ou RequiredVersion para especificar uma versão do módulo.
Save-Module -Name PowerShellGet -Path C:\Test\Modules -Repository PSGallery -MaximumVersion 2.1.0
Get-ChildItem -Path C:\Test\Modules\PowerShellGet\
Directory: C:\Test\Modules\PowerShellGet
Mode LastWriteTime Length Name
---- ------------- ------ ----
d----- 7/1/2019 13:40 2.1.0Save-Module utiliza o parâmetro Nome para especificar o módulo PowerShellGet. O parâmetro Caminho especifica onde armazenar o módulo transferido. O parâmetro Repositório especifica um repositório registado, PSGallery. MaximumVersion especifica que a versão 2.1.0 é transferida e guardada. Após a conclusão da transferência, Get-ChildItem apresenta o conteúdo do Caminho onde os ficheiros são armazenados.
Exemplo 3: localizar e guardar uma versão específica de um módulo
Neste exemplo, encontra-se uma versão do módulo necessária no repositório e guardada no computador local.
Find-Module -Name PowerShellGet -Repository PSGallery -RequiredVersion 1.6.5 |
Save-Module -Path C:\Test\Modules
Get-ChildItem -Path C:\Test\Modules\PowerShellGet
Directory: C:\Test\Modules\PowerShellGet
Mode LastWriteTime Length Name
---- ------------- ------ ----
d----- 7/1/2019 14:04 1.6.5Find-Module utiliza o parâmetro Nome para especificar o módulo PowerShellGet. O parâmetro Repositório especifica um repositório registado, PSGallery. RequiredVersion especifica a versão 1.6.5.
O objeto é enviado pelo pipeline para Save-Module. O parâmetro Caminho especifica onde armazenar o módulo transferido. Após a conclusão da transferência, Get-ChildItem apresenta o conteúdo do Caminho onde os ficheiros são armazenados.
Parâmetros
-AcceptLicense
O cmdlet proxy ignora este parâmetro, uma vez que não é suportado pelo Save-PSResource.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AllowPrerelease
Permite-lhe guardar um módulo marcado como pré-lançamento.
O cmdlet proxy mapeia este parâmetro para o parâmetro Pré-lançamento de Save-PSResource.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
Pede-lhe confirmação antes de executar o Save-Module.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Credential
Especifica uma conta de utilizador que tem direitos para guardar um módulo.
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Force
O cmdlet proxy ignora este parâmetro, uma vez que não é suportado pelo Save-PSResource.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InputObject
Aceita um objeto PSRepositoryItemInfo . Por exemplo, produza Find-Module para uma variável e utilize essa variável como argumento InputObject .
| Type: | PSObject[] |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-LiteralPath
Especifica um caminho para uma ou mais localizações. O valor do parâmetro LiteralPath é utilizado exatamente como introduzido. Nenhum caráter é interpretado como carateres universais. Se o caminho incluir carateres de escape, coloque-os entre aspas. O PowerShell não interpreta quaisquer carateres entre aspas individuais como sequências de escape.
O cmdlet proxy mapeia este parâmetro para o parâmetro Caminho de Save-PSResource.
| Type: | String |
| Aliases: | PSPath |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-MaximumVersion
O cmdlet proxy utiliza o valor deste parâmetro para criar uma cadeia de pesquisa de versão NuGet para utilização com o parâmetro Versão de Save-PSResource.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-MinimumVersion
O cmdlet proxy utiliza o valor deste parâmetro para criar uma cadeia de pesquisa de versão NuGet para utilização com o parâmetro Versão de Save-PSResource.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Name
Especifica uma matriz de nomes de módulos a guardar.
| Type: | String[] |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Path
Especifica a localização no computador local para armazenar um módulo guardado. Aceita carateres universais.
| Type: | String |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | True |
-Proxy
O cmdlet proxy ignora este parâmetro, uma vez que não é suportado pelo Save-PSResource.
| Type: | Uri |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ProxyCredential
O cmdlet proxy ignora este parâmetro, uma vez que não é suportado pelo Save-PSResource.
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Repository
Especifica o nome amigável de um repositório que foi registado ao executar Register-PSRepository. Utilizado Get-PSRepository para apresentar repositórios registados.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-RequiredVersion
O cmdlet proxy utiliza o valor deste parâmetro para criar uma cadeia de pesquisa de versão NuGet para utilização com o parâmetro Versão de Save-PSResource.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-WhatIf
Mostra o que aconteceria se as Save-Module execuções fossem executadas. 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[]
PSObject[]
Saídas
Notas
O Galeria do PowerShell já não suporta as versões 1.0 e 1.1 do Transport Layer Security (TLS). Tem de utilizar o TLS 1.2 ou superior. Utilize o seguinte comando para garantir que está a utilizar o TLS 1.2:
[Net.ServicePointManager]::SecurityProtocol = [Net.ServicePointManager]::SecurityProtocol -bor [Net.SecurityProtocolType]::Tls12
Comentários
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: https://aka.ms/ContentUserFeedback.
Submeter e ver comentários