Compartilhar via


Export-CrescendoModule

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

Sintaxe

Default (Padrão)

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 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 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 arquivos JSON que representam os proxies para o módulo.

Propriedades do parâmetro

Tipo:

String[]

Valor padrão:None
Dá suporte a curingas:True
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:1
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-Confirm

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:cf

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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 do parâmetro

Tipo:SwitchParameter
Valor padrão:False
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ModuleName

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

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:0
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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 do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-PassThru

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-WhatIf

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:wi

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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

Observações

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. Por fim, todos os proxies são usados para criar uma invocação 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 marca 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: