Export-CrescendoModule
Cria um módulo a partir de arquivos de configuração JSON do PowerShell Crescendo
Sintaxe
Default (Predefinição)
Export-CrescendoModule
[-ConfigurationFile] <String[]>
[-ModuleName] <String>
[-Force]
[-NoClobberManifest]
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Este cmdlet exporta um objeto que pode ser convertido em uma função que atua como um proxy para um comando específico da plataforma. O arquivo de módulo resultante deve ser executável até a versão 5.1 do PowerShell.
O cmdlet cria o .psm1 do módulo e o manifesto do módulo .psd1 arquivos. Isso pode criar problemas quando você personalizou o manifesto do módulo além do escopo do Crescendo. Use o NoClobberManifest parâmetro para impedir a substituição do manifesto.
Exemplos
EXEMPLO 1
Export-CrescendoModule -ModuleName netsh -ConfigurationFile netsh*.json
Import-Module ./netsh.psm1
EXEMPLO 2
Export-CrescendoModule netsh netsh*.json -force
Parâmetros
-ConfigurationFile
Esta é uma lista de arquivos JSON que representam os proxies para o módulo.
Propriedades dos parâmetros
| Tipo: | String[] |
| Default value: | None |
| Suporta carateres universais: | True |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | 1 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
-Confirm
Solicita confirmação antes de executar o cmdlet.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | None |
| 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
Por padrão, se Export-CrescendoModule não substituir um módulo existente. Use o parâmetro Force para substituir o arquivo existente ou removê-lo antes de executar Export-CrescendoModule.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | False |
| 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 |
-ModuleName
O nome do arquivo de módulo que você deseja criar. Você pode omitir o .psm1à direita .
Propriedades dos parâmetros
| Tipo: | String |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-NoClobberManifest
Impede a substituição do manifesto do módulo.
Você deve atualizar manualmente o manifesto com quaisquer novos cmdlets e configurações.
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 |
-PassThru
Emita um objeto com o caminho para .psm1 e os argumentos para New-ModuleManifest.
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 |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | None |
| 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.
Entradas
String
Saídas
Object
Notas
Internamente, essa função chama o cmdlet Import-CommandConfiguration que retorna um objeto de comando. Todos os arquivos fornecidos no parâmetro ConfigurationFile são usados para criar cada função individual. Finalmente, todos os proxies são usados para criar uma chamada de comando Export-ModuleMember, portanto, quando o módulo resultante é importado, o módulo tem todos os proxies de comando disponíveis.
Export-CrescendoModule adiciona a tag CrescendoBuilt ao manifesto do módulo. Você pode usar essa marca para localizar módulos na Galeria do PowerShell que foram criados usando o Crescendo. Para obter mais informações, consulte:
- Galeria de sintaxe de pesquisa
- Localizar-Módulo