Compartilhar via


Como importar cmdlets por meio de módulos

Este artigo descreve como importar cmdlets para uma sessão do PowerShell usando um módulo binário.

Observação

Os membros dos módulos podem incluir cmdlets, provedores, funções, variáveis, aliases e muito mais. Os snap-ins podem conter apenas cmdlets e provedores.

Como carregar cmdlets usando um módulo

  1. Crie uma pasta de módulo que tenha o mesmo nome do arquivo de assembly no qual os cmdlets são implementados. Neste procedimento, a pasta do módulo é criada na pasta system32 do Windows.

    %SystemRoot%\system32\WindowsPowerShell\v1.0\Modules\mymodule

  2. Verifique se a variável de ambiente PSModulePath inclui o caminho para sua nova pasta de módulo. Por padrão, a pasta do sistema já é adicionada à variável de ambiente PSModulePath. Para exibir o PSModulePath, digite: $Env:PSModulePath.

  3. Copie o assembly do cmdlet para a pasta do módulo.

  4. Adicione um arquivo de manifesto do módulo (.psd1) na pasta raiz do módulo. O PowerShell usa o manifesto do módulo para importar o módulo. Para obter mais informações, consulte Como escrever um manifesto de módulo do PowerShell.

  5. Execute o seguinte comando para adicionar os cmdlets à sessão:

    Import-Module [Module_Name]

    Este procedimento pode ser usado para testar seus cmdlets. Ele adiciona todos os cmdlets no assembly à sessão. Para obter mais informações sobre módulos, consulte Escrevendo um módulo do Windows PowerShell.

Consulte também

como gravar um manifesto do módulo do PowerShell

importando um módulo do PowerShell

import-module

instalando módulos

about_PSModulePath

gravando um cmdlet do Windows PowerShell