Compartilhar via


Export-CrescendoModule

Cria um módulo de arquivos de configuração JSON crescendo do PowerShell

Syntax

Export-CrescendoModule
      [-ConfigurationFile] <String[]>
      [-ModuleName] <String>
      [-Force]
      [-NoClobberManifest]
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Esse 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 módulo .psm1 e os arquivos de manifesto .psd1 do módulo. Isso pode criar problemas quando você personalizou o manifesto do módulo além do escopo do Crescendo. Use o parâmetro NoClobberManifest para evitar 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.

Type:String[]
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:True

-Confirm

Solicita sua confirmação antes de executar o cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ModuleName

O nome do arquivo de módulo que você deseja criar. Você pode omitir o à direita .psm1.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-NoClobberManifest

Impede a substituição do manifesto do módulo.

Você deve atualizar manualmente o manifesto com quaisquer novos cmdlets e configurações.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PassThru

Emita um objeto com o caminho para .psm1 e os argumentos para New-ModuleManifest.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

String[]

Saídas

Object

Observações

Internamente, essa função chama o Import-CommandConfiguration cmdlet que retorna um objeto de comando. Todos os arquivos fornecidos no parâmetro ConfigurationFile são usados para criar cada função individual. Por fim, todos os proxies são usados para criar uma Export-ModuleMember invocação de comando, portanto, quando o módulo resultante é importado, o módulo tem todos os proxies de comando disponíveis.

Export-CrescendoModule adiciona a marca CrescendoBuilt ao manifesto do módulo. Você pode usar essa marca para localizar módulos no Galeria do PowerShell que foram criados usando Crescendo. Para obter mais informações, consulte: