Partilhar via


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: