Import-Module

Syntaxe

Import-Module
      [-Global]
      [-Prefix <String>]
      [-Name] <String[]>
      [-Function <String[]>]
      [-Cmdlet <String[]>]
      [-Variable <String[]>]
      [-Alias <String[]>]
      [-Force]
      [-SkipEditionCheck]
      [-PassThru]
      [-AsCustomObject]
      [-MinimumVersion <Version>]
      [-MaximumVersion <String>]
      [-RequiredVersion <Version>]
      [-ArgumentList <Object[]>]
      [-DisableNameChecking]
      [-NoClobber]
      [-Scope <String>] 
      [<CommonParameters>]

Import-Module
      [-Global]
      [-Prefix <String>]
      [-Name] <String[]>
      [-Function <String[]>]
      [-Cmdlet <String[]>]
      [-Variable <String[]>]
      [-Alias <String[]>]
      [-Force]
      [-SkipEditionCheck]
      [-PassThru]
      [-AsCustomObject]
      [-MinimumVersion <Version>]
      [-MaximumVersion <String>]
      [-RequiredVersion <Version>]
      [-ArgumentList <Object[]>]
      [-DisableNameChecking]
      [-NoClobber]
      [-Scope <String>]
      -PSSession <PSSession> 
      [<CommonParameters>]

Import-Module
      [-Global]
      [-Prefix <String>]
      [-Name] <String[]>
      [-Function <String[]>]
      [-Cmdlet <String[]>]
      [-Variable <String[]>]
      [-Alias <String[]>]
      [-Force]
      [-SkipEditionCheck]
      [-PassThru]
      [-AsCustomObject]
      [-MinimumVersion <Version>]
      [-MaximumVersion <String>]
      [-RequiredVersion <Version>]
      [-ArgumentList <Object[]>]
      [-DisableNameChecking]
      [-NoClobber]
      [-Scope <String>]
      -CimSession <CimSession>
      [-CimResourceUri <Uri>]
      [-CimNamespace <String>]
      [<CommonParameters>]

Import-Module
      [-Name] <string[]>
      -UseWindowsPowerShell
      [-Global]
      [-Prefix <string>]
      [-Function <string[]>]
      [-Cmdlet <string[]>]
      [-Variable <string[]>]
      [-Alias <string[]>]
      [-Force]
      [-PassThru]
      [-AsCustomObject]
      [-MinimumVersion <version>]
      [-MaximumVersion <string>]
      [-RequiredVersion <version>]
      [-ArgumentList <Object[]>]
      [-DisableNameChecking]
      [-NoClobber]
      [-Scope <string>]
      [<CommonParameters>]

Import-Module
      [-Global]
      [-Prefix <String>]
      [-FullyQualifiedName] <ModuleSpecification[]>
      [-Function <String[]>]
      [-Cmdlet <String[]>]
      [-Variable <String[]>]
      [-Alias <String[]>]
      [-Force]
      [-SkipEditionCheck]
      [-PassThru]
      [-AsCustomObject]
      [-ArgumentList <Object[]>]
      [-DisableNameChecking]
      [-NoClobber]
      [-Scope <String>] 
      [<CommonParameters>]

Import-Module
      [-Global]
      [-Prefix <String>]
      [-FullyQualifiedName] <ModuleSpecification[]>
      [-Function <String[]>]
      [-Cmdlet <String[]>]
      [-Variable <String[]>]
      [-Alias <String[]>]
      [-Force]
      [-SkipEditionCheck]
      [-PassThru]
      [-AsCustomObject]
      [-ArgumentList <Object[]>]
      [-DisableNameChecking]
      [-NoClobber]
      [-Scope <String>]
      -PSSession <PSSession> 
      [<CommonParameters>]

Import-Module
      [-FullyQualifiedName] <ModuleSpecification[]>
      -UseWindowsPowerShell
      [-Global]
      [-Prefix <string>]
      [-Function <string[]>]
      [-Cmdlet <string[]>]
      [-Variable <string[]>]
      [-Alias <string[]>]
      [-Force]
      [-PassThru]
      [-AsCustomObject]
      [-ArgumentList <Object[]>]
      [-DisableNameChecking]
      [-NoClobber]
      [-Scope <string>]
      [<CommonParameters>]

Import-Module
      [-Global]
      [-Prefix <String>]
      [-Assembly] <Assembly[]>
      [-Function <String[]>]
      [-Cmdlet <String[]>]
      [-Variable <String[]>]
      [-Alias <String[]>]
      [-Force]
      [-SkipEditionCheck]
      [-PassThru]
      [-AsCustomObject]
      [-ArgumentList <Object[]>]
      [-DisableNameChecking]
      [-NoClobber]
      [-Scope <String>] 
      [<CommonParameters>]

Import-Module
      [-Global]
      [-Prefix <String>]
      [-Function <String[]>]
      [-Cmdlet <String[]>]
      [-Variable <String[]>]
      [-Alias <String[]>]
      [-Force]
      [-SkipEditionCheck]
      [-PassThru]
      [-AsCustomObject]
      [-ModuleInfo] <PSModuleInfo[]>
      [-ArgumentList <Object[]>]
      [-DisableNameChecking]
      [-NoClobber]
      [-Scope <String>] 
      [<CommonParameters>]

Description

L’applet Import-Module de commande ajoute un ou plusieurs modules à la session active. À compter de PowerShell 3.0, les modules installés sont automatiquement importés dans la session lorsque vous utilisez des commandes ou des fournisseurs dans le module. Toutefois, vous pouvez toujours utiliser la Import-Module commande pour importer un module. Vous pouvez désactiver l’importation automatique de modules à l’aide de la $PSModuleAutoloadingPreference variable de préférence. Pour plus d’informations sur la variable $PSModuleAutoloadingPreference, consultez about_Preference_Variables.

Un module est un package qui contient des membres qui peuvent être utilisés dans PowerShell. Les membres incluent des applets de commande, des fournisseurs, des scripts, des fonctions, des variables et d’autres outils et fichiers. Après avoir importé un module, vous pouvez utiliser ses membres dans votre session. Pour plus d’informations sur les modules, consultez about_Modules.

Par défaut, Import-Module importe tous les membres exportés par le module, mais vous pouvez utiliser les paramètres Alias, Fonction, Applet de commande et Variable pour restreindre les membres importés. Le paramètre NoClobber empêche Import-Module l’importation de membres ayant les mêmes noms que les membres de la session active.

Import-Module importe un module uniquement dans la session active. Pour importer le module dans chaque nouvelle session, ajoutez une Import-Module commande à votre profil PowerShell. Pour plus d'informations sur les profils, consultez about_Profiles.

Vous pouvez gérer les ordinateurs Windows distants avec la communication à distance PowerShell activée en créant une session PSSession sur l’ordinateur distant. Utilisez ensuite le paramètre PSSession pour Import-Module importer les modules installés sur l’ordinateur distant. Lorsque vous utilisez les commandes importées dans la session active, les commandes s’exécutent implicitement sur l’ordinateur distant.

À compter de Windows PowerShell 3.0, vous pouvez utiliser Import-Module pour importer des modules CIM (Common Information Model). Les modules CIM définissent les applets de commande dans les fichiers CDXML (Cmdlet Definition XML). Cette fonctionnalité vous permet d’utiliser des applets de commande implémentées dans des assemblys de code non managés, tels que ceux écrits en C++.

Pour les ordinateurs distants qui n’ont pas activé la communication à distance PowerShell, y compris les ordinateurs qui n’exécutent pas le système d’exploitation Windows, vous pouvez utiliser le paramètre CIMSession de Import-Module pour importer des modules CIM à partir de l’ordinateur distant. Les commandes importées s’exécutent implicitement sur l’ordinateur distant. Une session CIMSession est une connexion à Windows Management Instrumentation (WMI) sur l’ordinateur distant.

Exemples

Exemple 1 : Importer les membres d’un module dans la session active

Cet exemple importe les membres du module PSDiagnostics dans la session active.

Import-Module -Name PSDiagnostics

Exemple 2 : Importer tous les modules spécifiés par le chemin du module

Cet exemple importe tous les modules disponibles dans le chemin spécifié par la $env:PSModulePath variable d’environnement dans la session active.

Get-Module -ListAvailable | Import-Module

Exemple 3 : Importer les membres de plusieurs modules dans la session active

Cet exemple importe les membres des modules PSDiagnostics et Dism dans la session active.

$m = Get-Module -ListAvailable PSDiagnostics, Dism
Import-Module -ModuleInfo $m

L’applet Get-Module de commande obtient les modules PSDiagnostics et Dism et enregistre les objets dans la $m variable. Le paramètre ListAvailable est requis lorsque vous obtenez des modules qui ne sont pas encore importés dans la session.

Le paramètre ModuleInfo de Import-Module est utilisé pour importer les modules dans la session active.

Exemple 4 : Importer tous les modules spécifiés par un chemin d’accès

Cet exemple utilise un chemin d’accès explicite pour identifier le module à importer.

Import-Module -Name c:\ps-test\modules\test -Verbose

VERBOSE: Loading module from path 'C:\ps-test\modules\Test\Test.psm1'.
VERBOSE: Exporting function 'my-parm'.
VERBOSE: Exporting function 'Get-Parameter'.
VERBOSE: Exporting function 'Get-Specification'.
VERBOSE: Exporting function 'Get-SpecDetails'.

L’utilisation du paramètre Verbose entraîne Import-Module l’état de progression au fur et à mesure qu’il charge le module. Sans le paramètre Verbose, PassThru ou AsCustomObject , Import-Module ne génère aucune sortie lorsqu’il importe un module.

Exemple 5 : Restreindre les membres du module importés dans une session

Cet exemple montre comment restreindre les membres du module importés dans la session et l’effet de cette commande sur la session. Le paramètre Function limite les membres importés à partir du module. Vous pouvez également utiliser les paramètres Alias, Variable et Applet de commande pour restreindre les autres membres qu’un module importe.

L’applet Get-Module de commande obtient l’objet qui représente le module PSDiagnostics . La propriété ExportedCmdlets répertorie toutes les applets de commande que le module exporte, même si elles n’ont pas toutes été importées.

Import-Module PSDiagnostics -Function Disable-PSTrace, Enable-PSTrace
(Get-Module PSDiagnostics).ExportedCommands

Key                          Value
---                          -----
Disable-PSTrace              Disable-PSTrace
Disable-PSWSManCombinedTrace Disable-PSWSManCombinedTrace
Disable-WSManTrace           Disable-WSManTrace
Enable-PSTrace               Enable-PSTrace
Enable-PSWSManCombinedTrace  Enable-PSWSManCombinedTrace
Enable-WSManTrace            Enable-WSManTrace
Get-LogProperties            Get-LogProperties
Set-LogProperties            Set-LogProperties
Start-Trace                  Start-Trace
Stop-Trace                   Stop-Trace

Get-Command -Module PSDiagnostics

CommandType     Name                 Version    Source
-----------     ----                 -------    ------
Function        Disable-PSTrace      6.1.0.0    PSDiagnostics
Function        Enable-PSTrace       6.1.0.0    PSDiagnostics

L’utilisation du paramètre Module de l’applet Get-Command de commande affiche les commandes qui ont été importées à partir du module PSDiagnostics . Les résultats confirment que seules les applets de commande et Enable-PSTrace les Disable-PSTrace applets de commande ont été importées.

Exemple 6 : Importer les membres d’un module et ajouter un préfixe

Cet exemple importe le module PSDiagnostics dans la session active, ajoute un préfixe aux noms de membres, puis affiche les noms de membres préfixés. Paramètre Préfixe d’ajout Import-Module du x préfixe à tous les membres importés à partir du module. Le préfixe s’applique uniquement aux membres de la session active. Il ne modifie pas le module. Le paramètre PassThru retourne un objet de module qui représente le module importé.

Import-Module PSDiagnostics -Prefix x -PassThru

ModuleType Version    Name               ExportedCommands
---------- -------    ----               ----------------
Script     6.1.0.0    PSDiagnostics      {Disable-xPSTrace, Disable-xPSWSManCombinedTrace, Disable-xW...

Get-Command -Module PSDiagnostics

CommandType     Name                                   Version    Source
-----------     ----                                   -------    ------
Function        Disable-xPSTrace                       6.1.0.0    PSDiagnostics
Function        Disable-xPSWSManCombinedTrace          6.1.0.0    PSDiagnostics
Function        Disable-xWSManTrace                    6.1.0.0    PSDiagnostics
Function        Enable-xPSTrace                        6.1.0.0    PSDiagnostics
Function        Enable-xPSWSManCombinedTrace           6.1.0.0    PSDiagnostics
Function        Enable-xWSManTrace                     6.1.0.0    PSDiagnostics
Function        Get-xLogProperties                     6.1.0.0    PSDiagnostics
Function        Set-xLogProperties                     6.1.0.0    PSDiagnostics
Function        Start-xTrace                           6.1.0.0    PSDiagnostics
Function        Stop-xTrace                            6.1.0.0    PSDiagnostics

Get-Command obtient les membres qui ont été importés à partir du module. La sortie indique que les membres de module ont été correctement préfixés.

Exemple 7 : Obtenir et utiliser un objet personnalisé

Cet exemple montre comment obtenir et utiliser l’objet personnalisé retourné par Import-Module.

Les objets personnalisés incluent des membres synthétiques représentant chacun des membres de module importés. Par exemple, les applets de commande et les fonctions dans un module sont converties en méthodes de script de l'objet personnalisé.

Les objets personnalisés sont utiles dans le script. Ils sont également utiles lorsque plusieurs objets importés ont les mêmes noms. Utiliser la méthode de script d'un objet équivaut à spécifier le nom qualifié complet d'un membre importé, y compris son nom de module.

Le paramètre AsCustomObject est utilisable uniquement lors de l’importation d’un module de script. Permet Get-Module de déterminer quels modules disponibles sont un module de script.

Get-Module -List | Format-Table -Property Name, ModuleType -AutoSize

Name          ModuleType
----          ----------
Show-Calendar     Script
BitsTransfer    Manifest
PSDiagnostics   Manifest
TestCmdlets       Script
...

$a = Import-Module -Name Show-Calendar -AsCustomObject -PassThru
$a | Get-Member

TypeName: System.Management.Automation.PSCustomObject
Name          MemberType   Definition
----          ----------   ----------
Equals        Method       bool Equals(System.Object obj)
GetHashCode   Method       int GetHashCode()
GetType       Method       type GetType()
ToString      Method       string ToString()
Show-Calendar ScriptMethod System.Object Show-Calendar();

$a."Show-Calendar"()

Le Show-Calendar module de script est importé à l’aide du paramètre AsCustomObject pour demander un objet personnalisé et le paramètre PassThru pour renvoyer l’objet. L’objet personnalisé résultant est enregistré dans la $a variable.

La $a variable est redirigée vers l’applet Get-Member de commande pour afficher les propriétés et méthodes de l’objet enregistré. La sortie affiche une Show-Calendar méthode de script.

Pour appeler la méthode de Show-Calendar script, le nom de la méthode doit être placé entre guillemets, car le nom inclut un trait d’union.

Exemple 8 : Réimporter un module dans la même session

Cet exemple montre comment utiliser le paramètre Force du Import-Module moment où vous importez un module dans la même session. Le paramètre Force supprime le module chargé, puis l’importe à nouveau.

Import-Module PSDiagnostics
Import-Module PSDiagnostics -Force -Prefix PS

La première commande importe le module PSDiagnostics . La deuxième commande importe à nouveau le module, cette fois à l’aide du paramètre Préfixe .

Sans le paramètre Force , la session inclurait deux copies de chaque applet de commande PSDiagnostics , une avec le nom standard et l’autre avec le nom préfixé.

Exemple 9 : Exécuter des commandes qui ont été masquées par des commandes importées

Cet exemple montre comment exécuter des commandes qui ont été masquées par des commandes importées. Le module TestModule inclut une fonction nommée Get-Date qui retourne l’année et le jour de l’année.

Get-Date

Thursday, August 15, 2019 2:26:12 PM

Import-Module TestModule
Get-Date

19227

Get-Command Get-Date -All | Format-Table -Property CommandType, Name, ModuleName -AutoSize

CommandType     Name         ModuleName
-----------     ----         ----------
Function        Get-Date     TestModule
Cmdlet          Get-Date     Microsoft.PowerShell.Utility

Microsoft.PowerShell.Utility\Get-Date

Thursday, August 15, 2019 2:28:31 PM

La première Get-Date applet de commande retourne un objet DateTime avec la date actuelle. Après avoir importé le module TestModule , Get-Date retourne l’année et le jour de l’année.

À l’aide du paramètre All d’afficher Get-Command toutes les Get-Date commandes de la session. Les résultats montrent qu’il existe deux Get-Date commandes dans la session, une fonction du module TestModule et une applet de commande du module Microsoft.PowerShell.Utility .

Étant donné que les fonctions sont prioritaires sur les applets de commande, la Get-Date fonction du module TestModule s’exécute, au lieu de l’applet Get-Date de commande. Pour exécuter la version d’origine de , vous devez qualifier le nom de Get-Datela commande avec le nom du module.

Pour plus d’informations sur la priorité des commandes dans PowerShell, consultez about_Command_Precedence.

Exemple 10 : Importer une version minimale d’un module

Cet exemple importe le module PowerShellGet . Il utilise le paramètre MinimumVersion de Import-Module pour importer uniquement la version ou une version 2.0.0 ultérieure du module.

Import-Module -Name PowerShellGet -MinimumVersion 2.0.0

Vous pouvez également utiliser le paramètre RequiredVersion pour importer une version particulière d’un module, ou utiliser les paramètres Module et Version du #Requires mot clé pour exiger une version particulière d’un module dans un script.

Exemple 11 : Importer à l’aide d’un nom complet

Cet exemple importe une version spécifique d’un module à l’aide de FullyQualifiedName.

PS> Get-Module -ListAvailable PowerShellGet | Select-Object Name, Version

Name          Version
----          -------
PowerShellGet 2.2.1
PowerShellGet 2.1.3
PowerShellGet 2.1.2
PowerShellGet 1.0.0.1

PS> Import-Module -FullyQualifiedName @{ModuleName = 'PowerShellGet'; ModuleVersion = '2.1.3' }

Exemple 12 : Importer à l’aide d’un chemin complet

Cet exemple importe une version spécifique d’un module à l’aide du chemin complet.

PS> Get-Module -ListAvailable PowerShellGet | Select-Object Path

Path
----
C:\Program Files\PowerShell\Modules\PowerShellGet\2.2.1\PowerShellGet.psd1
C:\program files\powershell\6\Modules\PowerShellGet\PowerShellGet.psd1
C:\Program Files\WindowsPowerShell\Modules\PowerShellGet\2.1.2\PowerShellGet.psd1
C:\Program Files\WindowsPowerShell\Modules\PowerShellGet\1.0.0.1\PowerShellGet.psd1

PS> Import-Module -Name 'C:\Program Files\PowerShell\Modules\PowerShellGet\2.2.1\PowerShellGet.psd1'

Exemple 13 : Importer un module à partir d’un ordinateur distant

Cet exemple montre comment utiliser l’applet Import-Module de commande pour importer un module à partir d’un ordinateur distant. Cette commande utilise la fonctionnalité de communication à distance implicite de PowerShell.

Quand vous importez des modules à partir d'une autre session, vous pouvez utiliser les applets de commande dans la session active. Toutefois, les commandes qui utilisent les applets de commande s’exécutent dans la session à distance.

$s = New-PSSession -ComputerName Server01
Get-Module -PSSession $s -ListAvailable -Name NetSecurity

ModuleType Name             ExportedCommands
---------- ----             ----------------
Manifest   NetSecurity      {New-NetIPsecAuthProposal, New-NetIPsecMainModeCryptoProposal, New-Ne...

Import-Module -PSSession $s -Name NetSecurity
Get-Command -Module NetSecurity -Name Get-*Firewall*

CommandType     Name                                               ModuleName
-----------     ----                                               ----------
Function        Get-NetFirewallAddressFilter                       NetSecurity
Function        Get-NetFirewallApplicationFilter                   NetSecurity
Function        Get-NetFirewallInterfaceFilter                     NetSecurity
Function        Get-NetFirewallInterfaceTypeFilter                 NetSecurity
Function        Get-NetFirewallPortFilter                          NetSecurity
Function        Get-NetFirewallProfile                             NetSecurity
Function        Get-NetFirewallRule                                NetSecurity
Function        Get-NetFirewallSecurityFilter                      NetSecurity
Function        Get-NetFirewallServiceFilter                       NetSecurity
Function        Get-NetFirewallSetting                             NetSecurity

Get-NetFirewallRule -DisplayName "Windows Remote Management*" |
  Format-Table -Property DisplayName, Name -AutoSize

DisplayName                                              Name
-----------                                              ----
Windows Remote Management (HTTP-In)                      WINRM-HTTP-In-TCP
Windows Remote Management (HTTP-In)                      WINRM-HTTP-In-TCP-PUBLIC
Windows Remote Management - Compatibility Mode (HTTP-In) WINRM-HTTP-Compat-In-TCP

New-PSSession crée une session distante (PSSession) sur l’ordinateur Server01 . La session PSSession est enregistrée dans la $s variable.

L’exécution Get-Module avec le paramètre PSSession indique que le module NetSecurity est installé et disponible sur l’ordinateur distant. Cette commande équivaut à utiliser l’applet Invoke-Command de commande pour exécuter Get-Module la commande dans la session à distance. Par exemple :

Invoke-Command $s {Get-Module -ListAvailable -Name NetSecurity

L’exécution Import-Module avec le paramètre PSSession importe le module NetSecurity à partir de l’ordinateur distant dans la session active. L’applet Get-Command de commande récupère les commandes qui commencent par Get le module NetSecurity et les incluent Firewall . La sortie confirme que le module et ses applets de commande ont été importés dans la session active.

Ensuite, l’applet Get-NetFirewallRule de commande obtient des règles de pare-feu de gestion à distance Windows sur l’ordinateur Server01 . Cela équivaut à utiliser l’applet Invoke-Command de commande pour s’exécuter Get-NetFirewallRule sur la session à distance.

Exemple 14 : Gérer le stockage sur un ordinateur distant sans le système d’exploitation Windows

Dans cet exemple, l’administrateur de l’ordinateur a installé le fournisseur WMI de découverte de modules, ce qui vous permet d’utiliser des commandes CIM conçues pour le fournisseur.

L’applet New-CimSession de commande crée une session sur l’ordinateur distant nommé RSDGF03. La session se connecte au service WMI sur l’ordinateur distant. La session CIM est enregistrée dans la $cs variable. Import-Moduleutilise cimSession in pour importer le module CIM de stockage à partir de l’ordinateurRSDGF03.$cs

L’applet Get-Command de commande affiche la Get-Disk commande dans le module De stockage . Lorsque vous importez un module CIM dans la session locale, PowerShell convertit les fichiers CDXML pour chaque commande en scripts PowerShell, qui apparaissent en tant que fonctions dans la session locale.

Bien qu’elle Get-Disk soit typée dans la session locale, l’applet de commande s’exécute implicitement sur l’ordinateur distant à partir duquel elle a été importée. La commande retourne des objets de l’ordinateur distant à la session locale.

$cs = New-CimSession -ComputerName RSDGF03
Import-Module -CimSession $cs -Name Storage
# Importing a CIM module, converts the CDXML files for each command into
# PowerShell scripts. These appear as functions in the local session.
Get-Command Get-Disk

CommandType     Name                  ModuleName
-----------     ----                  ----------
Function        Get-Disk              Storage

# Use implicit remoting to query disks on the remote computer from which the
# module was imported.
Get-Disk

Number Friendly Name           OperationalStatus  Total Size Partition Style
------ -------------           -----------------  ---------- ---------------
0      Virtual HD ATA Device   Online                  40 GB MBR

Paramètres

-Alias

-ArgumentList

-AsCustomObject

-Assembly

-CimNamespace

-CimResourceUri

-CimSession

-Cmdlet

-DisableNameChecking

-Force

-FullyQualifiedName

-Function

-Global

-MaximumVersion

-MinimumVersion

-ModuleInfo

-Name

-NoClobber

-PassThru

-Prefix

-PSSession

-RequiredVersion

-Scope

-SkipEditionCheck

-UseWindowsPowerShell

-Variable

Entrées

String

Vous pouvez diriger un nom de module vers cette applet de commande.

PSModuleInfo

Vous pouvez diriger un objet de module vers cette applet de commande.

Assembly

Vous pouvez diriger un objet d’assembly vers cette applet de commande.

Sorties

None

Par défaut, cette applet de commande ne retourne aucune sortie.

PSModuleInfo

Si vous spécifiez le paramètre PassThru , l’applet de commande génère un objet System.Management.Automation.PSModuleInfo qui représente le module importé.

PSCustomObject

Si vous spécifiez ensemble les paramètres AsCustomObject et PassThru , l’applet de commande génère un objet PSCustomObject qui représente le module.

Notes

PowerShell inclut les alias suivants pour Import-Module:

• Toutes les plateformes :

  • ipmo

• Avant de pouvoir importer un module, le module doit être accessible à votre ordinateur local et inclus dans la PSModulePath variable environnementale. Pour plus d’informations, consultez about_Modules.

  Vous pouvez également utiliser les paramètres PSSession et CIMSession pour importer des modules installés sur des ordinateurs distants. Toutefois, les commandes qui utilisent les applets de commande de ces modules s’exécutent dans la session à distance sur l’ordinateur distant.

• Si vous importez des membres portant le même nom et le même type dans votre session, PowerShell utilise le membre importé en dernier par défaut. Les variables et les alias sont remplacés et les originaux ne sont pas accessibles. Les fonctions, applets de commande et fournisseurs sont simplement ombrées par les nouveaux membres. Ils sont accessibles en sélectionnant le nom de la commande avec le nom de son composant logiciel enfichable, de son module ou de son chemin de fonction.

• Pour mettre à jour les données de mise en forme des commandes importées à partir d’un module, utilisez l’applet Update-FormatData de commande. Si le fichier de mise en forme d’un module change, utilisez l’applet Update-FormatData de commande pour mettre à jour les données de mise en forme pour les commandes importées. Vous n’avez pas besoin d’importer à nouveau le module.

• À compter de Windows PowerShell 3.0, les commandes principales installées avec PowerShell sont empaquetées dans les modules. Dans Windows PowerShell 2.0 et dans les programmes hôtes qui créent des sessions de style plus ancien dans les versions ultérieures de PowerShell, les commandes principales sont empaquetées dans les composants logiciels enfichables (PSSnapins). L’exception est Microsoft.PowerShell.Core, qui est toujours un composant logiciel enfichable. En outre, les sessions distantes, telles que celles démarrées par l’applet New-PSSession de commande, sont des sessions de style plus ancien qui incluent des composants logiciels enfichables principaux.

  Pour plus d’informations sur la méthode CreateDefault2 qui crée des sessions de style plus récents avec des modules principaux, consultez la méthode CreateDefault2.

• Dans Windows PowerShell 2.0, certaines valeurs de propriété de l’objet de module, telles que les valeurs de propriété ExportedCmdlets et NestedModules , n’ont pas été remplies tant que le module n’a pas été importé.

• Si vous tentez d’importer un module qui contient des assemblys en mode mixte qui ne sont pas compatibles avec Windows PowerShell 3.0+, Import-Module retourne un message d’erreur comme celui suivant.

  Import-Module : l’assembly en mode mixte est généré sur la version « v2.0.50727 » du runtime et ne peut pas être chargé dans le runtime 4.0 sans informations de configuration supplémentaires.

  Cette erreur se produit lorsqu’un module conçu pour Windows PowerShell 2.0 contient au moins un assembly de module mixte. Assembly de module mixte qui inclut à la fois du code managé et non managé, tel que C++ et C#.

  Pour importer un module qui contient des assemblys en mode mixte, démarrez Windows PowerShell 2.0 à l’aide de la commande suivante, puis réessayez la Import-Module commande.

  PowerShell.exe -Version 2.0

• Pour utiliser la fonctionnalité de session CIM, l'ordinateur distant doit disposer de l'accès distant WS-Management et de Windows Management Instrumentation (WMI), qui est l'implémentation Microsoft du modèle CIM (Common Information Model) standard. L'ordinateur doit également disposer du fournisseur WMI pour la découverte de module ou un autre fournisseur CIM qui a les mêmes fonctionnalités de base.

  Vous pouvez utiliser la fonctionnalité de session CIM sur les ordinateurs qui n’exécutent pas de système d’exploitation Windows et sur les ordinateurs Windows qui ont PowerShell, mais qui n’ont pas activé la communication à distance PowerShell.

  Vous pouvez également utiliser les paramètres CIM pour obtenir des modules CIM à partir d’ordinateurs sur lesquels la communication à distance PowerShell est activée, y compris l’ordinateur local. Lorsque vous créez une session CIM sur l’ordinateur local, PowerShell utilise DCOM, au lieu de WMI, pour créer la session.

• Par défaut, Import-Module importe des modules dans l’étendue globale, même lorsqu’ils sont appelés à partir d’une étendue descendante. L’étendue de niveau supérieur et toutes les étendues descendantes ont accès aux éléments exportés du module.

  Dans une étendue descendante, -Scope Local limite l’importation à cette étendue et à toutes ses étendues descendantes. Les étendues parentes ne voient pas les membres importés.

  Remarque

  Get-Module affiche tous les modules chargés dans la session active. Cela inclut les modules chargés localement dans une étendue descendante. Permet Get-Command -Module modulename de voir quels membres sont chargés dans l’étendue actuelle.

• Import-Module ne charge pas les définitions de classe et d’énumération dans le module. Utilisez l’instruction using module au début de votre script. Cela importe le module, y compris les définitions de classe et d’énumération. Pour plus d’informations, consultez about_Using.

• Pendant le développement d’un module de script, il est courant d’apporter des modifications au code, puis de charger la nouvelle version du module à l’aide Import-Module du paramètre Force . Cela fonctionne uniquement pour les modifications apportées aux fonctions dans le module racine. Import-Module ne recharge aucun module imbriqué. En outre, il n’existe aucun moyen de charger des classes ou énumérations mises à jour.

  Pour obtenir les membres de module mis à jour définis dans les modules imbriqués, supprimez le module avec Remove-Module, puis réimportez le module.

  Si le module a été chargé avec une using instruction, vous devez démarrer une nouvelle session pour importer des définitions mises à jour pour les classes et les énumérations. Les classes et les énumérations définies dans PowerShell et importées avec une using instruction ne peuvent pas être déchargées.

Liens associés

• about_Modules
• Export-ModuleMember
• Get-Module
• New-Module
• Remove-Module
• about_PowerShell_Editions