O cmdlet Save-Module baixa um módulo e quaisquer dependências de um repositório registrado.
Save-Module baixa e salva a versão mais atual de um módulo. Os arquivos são salvos em um caminho especificado no computador local. O módulo não está instalado, mas o conteúdo está disponível para inspeção por um administrador.
Get-PSRepository exibe os repositórios registrados do computador local. Você pode usar o cmdlet Find-Module para pesquisar repositórios registrados.
Exemplos
Exemplo 1: Salvar um módulo
Neste exemplo, um módulo e suas dependências são salvos no computador local.
Save-Module usa o parâmetro Name para especificar o módulo, PowerShellGet. O parâmetro Path especifica onde armazenar o módulo baixado. O parâmetro Repository especifica um repositório registrado, PSGallery. Após a conclusão do download, Get-ChildItem exibe o conteúdo do Path onde os arquivos estão armazenados.
Exemplo 2: Salvar uma versão específica de um módulo
Este exemplo mostra como usar um parâmetro como MaximumVersionou RequiredVersion para especificar uma versão do módulo.
Save-Module usa o parâmetro Name para especificar o módulo, PowerShellGet. O parâmetro Path especifica onde armazenar o módulo baixado. O parâmetro Repository especifica um repositório registrado, PSGallery.
MaximumVersion especifica que a versão 2.1.0 é baixada e salva. Após a conclusão do download, Get-ChildItem exibe o conteúdo do Path onde os arquivos estão armazenados.
Exemplo 3: Localizar e guardar uma versão específica de um módulo
Neste exemplo, uma versão do módulo necessária é encontrada no repositório e salva no computador local.
Find-Module usa o parâmetro Name para especificar o módulo, PowerShellGet. O parâmetro Repository especifica um repositório registrado, PSGallery.
RequiredVersion especifica a versão 1.6.5.
O objeto é enviado pelo pipeline para Save-Module. O parâmetro Path especifica onde armazenar o módulo baixado. Após a conclusão do download, Get-ChildItem exibe o conteúdo do Path onde os arquivos estão armazenados.
Parâmetros
-Confirm
Solicita confirmação antes de executar o Save-Module.
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
-Force
Força Save-Module a executar 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
-InputObject
Aceita um objeto PSRepositoryItemInfo. Por exemplo, a saída a uma variável e use essa variável como o argumento InputObject.
Propriedades dos parâmetros
Tipo:
PSObject[]
Default value:
None
Suporta carateres universais:
False
NãoMostrar:
False
Conjuntos de parâmetros
InputObjectAndLiteralPathParameterSet
Position:
0
Obrigatório:
True
Valor do pipeline:
True
Valor do pipeline por nome de propriedade:
True
Valor dos restantes argumentos:
False
InputObjectAndPathParameterSet
Position:
0
Obrigatório:
True
Valor do pipeline:
True
Valor do pipeline por nome de propriedade:
True
Valor dos restantes argumentos:
False
-LiteralPath
Especifica um caminho para um ou mais locais. O valor do parâmetro LiteralPath é usado exatamente como inserido. Nenhum caractere é interpretado como carta curinga. Se o caminho incluir caracteres de escape, coloque-os entre aspas simples. O PowerShell não interpreta nenhum caractere entre aspas simples como sequências de escape.
Propriedades dos parâmetros
Tipo:
String
Default value:
None
Suporta carateres universais:
False
NãoMostrar:
False
Conjuntos de parâmetros
NameAndLiteralPathParameterSet
Position:
Named
Obrigatório:
True
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
InputObjectAndLiteralPathParameterSet
Position:
Named
Obrigatório:
True
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
-MaximumVersion
Especifica a versão máxima, ou mais recente, do módulo a ser salvo. Os parâmetros MaximumVersion e RequiredVersion não podem ser usados no mesmo comando.
Propriedades dos parâmetros
Tipo:
Version
Default value:
None
Suporta carateres universais:
False
NãoMostrar:
False
Conjuntos de parâmetros
NameAndPathParameterSet
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
True
Valor dos restantes argumentos:
False
NameAndLiteralPathParameterSet
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
True
Valor dos restantes argumentos:
False
-MinimumVersion
Especifica a versão mínima de um único módulo a ser salvo. Não é possível adicionar esse parâmetro se estiver tentando instalar vários módulos. Os parâmetros MinimumVersion e RequiredVersion não podem ser usados no mesmo comando.
Propriedades dos parâmetros
Tipo:
Version
Default value:
None
Suporta carateres universais:
False
NãoMostrar:
False
Aliases:
Versão
Conjuntos de parâmetros
NameAndPathParameterSet
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
True
Valor dos restantes argumentos:
False
NameAndLiteralPathParameterSet
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
True
Valor dos restantes argumentos:
False
-Name
Especifica uma matriz de nomes de módulos a serem salvos.
Propriedades dos parâmetros
Tipo:
String[]
Default value:
None
Suporta carateres universais:
False
NãoMostrar:
False
Conjuntos de parâmetros
NameAndPathParameterSet
Position:
0
Obrigatório:
True
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
True
Valor dos restantes argumentos:
False
NameAndLiteralPathParameterSet
Position:
0
Obrigatório:
True
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
True
Valor dos restantes argumentos:
False
-Path
Especifica o local no computador local para armazenar um módulo salvo. Aceita caracteres curinga.
Propriedades dos parâmetros
Tipo:
String
Default value:
None
Suporta carateres universais:
True
NãoMostrar:
False
Conjuntos de parâmetros
NameAndPathParameterSet
Position:
1
Obrigatório:
True
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
InputObjectAndPathParameterSet
Position:
1
Obrigatório:
True
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
False
Valor dos restantes argumentos:
False
-Repository
Especifica o nome amigável de um repositório que foi registrado executando Register-PSRepositoryo . Use Get-PSRepository para exibir repositórios registrados.
Propriedades dos parâmetros
Tipo:
String[]
Default value:
None
Suporta carateres universais:
False
NãoMostrar:
False
Conjuntos de parâmetros
NameAndPathParameterSet
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
True
Valor dos restantes argumentos:
False
NameAndLiteralPathParameterSet
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
True
Valor dos restantes argumentos:
False
-RequiredVersion
Especifica o número exato da versão do módulo a ser salvo.
Propriedades dos parâmetros
Tipo:
Version
Default value:
None
Suporta carateres universais:
False
NãoMostrar:
False
Conjuntos de parâmetros
NameAndPathParameterSet
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
True
Valor dos restantes argumentos:
False
NameAndLiteralPathParameterSet
Position:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome de propriedade:
True
Valor dos restantes argumentos:
False
-WhatIf
Mostra o que aconteceria se o Save-Module 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.