Partilhar via

Export-CrescendoModule

  • Referência
Módulo:
Microsoft.PowerShell.Crescendo

Cria um módulo a partir de ficheiros de configuração JSON crescendo do PowerShell

Syntax

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

Description

Este cmdlet exporta um objeto que pode ser convertido numa função que atua como um proxy para um comando específico da plataforma. O ficheiro de módulo resultante deve ser executável até à versão 5.1 do PowerShell.

O cmdlet cria o módulo .psm1 e os ficheiros de manifesto .psd1 do módulo. Isto pode criar problemas quando personalizou o manifesto do módulo para além do âmbito do Crescendo. Utilize o parâmetro NoClobberManifest 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 ficheiros JSON que representam os proxies do módulo.

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

-Confirm

Solicita a 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 predefinição, se Export-CrescendoModule não substituir um módulo existente. Utilize o parâmetro Forçar para substituir o ficheiro existente ou remova-o 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 ficheiro de módulo que pretende criar. Pode omitir o seguinte .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.

Tem de atualizar manualmente o manifesto com quaisquer novos cmdlets e definiçõ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

Apresenta o que aconteceria mediante a execução do cmdlet. 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

Notas

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

Export-CrescendoModule adiciona a etiqueta CrescendoBuilt ao manifesto do módulo. Pode utilizar esta etiqueta para localizar módulos no Galeria do PowerShell que foram criados com o Crescendo. Para obter mais informações, consulte: