How to Import Cmdlets Using Modules (Como Importar Cmdlets Através 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 Windows system32.

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

2. Certifique-se de que a variável de ambiente PSModulePath inclui o caminho para a nova pasta do módulo. Por padrão, a pasta do sistema já foi adicionada à variável de ambiente PSModulePath. Para visualizar 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 seu módulo. Para obter mais informações, consulte Como escrever um manifesto do módulo 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.

Ver também

Como escrever um manifesto de módulo do PowerShell

Importando um módulo do PowerShell

Import-Module

Instalação de módulos

about_PSModulePath

Escrevendo um cmdlet do Windows PowerShell