lundi 5 décembre 2011

Import-Module

NOM
    Import-Module

RÉSUMÉ
    Ajoute des modules à la session active.

SYNTAXE
    Import-Module [-Name] <string[]> [-Alias <string[]>] [-ArgumentList <Object[]>] [-AsCustomObject] [-Cmdlet <string[]>] [-Force] [-Function <string[]>] [-Global] [-PassThru] [-Prefix <string>] [-Variable <string[]>] [-Version <Version>] [<CommonParameters>]

    Import-Module [-Assembly] <Assembly[]> [-Alias <string[]>] [-ArgumentList <Object[]>] [-AsCustomObject] [-Cmdlet <string[]>] [-Force] [-Function <string[]>] [-Global] [-PassThru] [-Prefix <string>] [-Variable <string[]>] [-Version <Version>] [<CommonParameters>]

    Import-Module [-ModuleInfo] <PSModuleInfo[]> [-Alias <string[]>] [-ArgumentList <Object[]>] [-AsCustomObject] [-Cmdlet <string[]>] [-Force] [-Function <string[]>] [-Global] [-PassThru] [-Prefix <string>] [-Variable <string[]>] [-Version <Version>] [<CommonParameters>]


DESCRIPTION
    L'applet de commande Import-Module ajoute un ou plusieurs modules à la session active.

    Un module est un package contenant des membres (tels que des applets de commande, des fournisseurs, des scripts, des fonctions, des variables et d'autres outils et fichiers) qui peuvent être utilisés dans Windows PowerShell. Après avoir importé un module, vous pouvez utiliser ses membres dans votre session.

    Utilisez le paramètre Name, Assembly ou ModuleInfo pour identifier le module à importer. Par défaut, Import-Module importe tous les membres que le module exporte, mais vous pouvez utiliser les paramètres Alias, Function, Cmdlet et Variable pour restreindre les membres importés.

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

    Pour plus d'informations sur les modules, consultez about_Modules.


PARAMÈTRES
    -Alias <string[]>
        Importe uniquement les alias spécifiés à partir du module dans la session active. Entrez une liste d'alias séparés par des virgules. Les caractères génériques sont autorisés.

        Certains modules exportent automatiquement certains alias dans votre session lorsque vous importez le module. Ce paramètre vous permet d'effectuer une sélection parmi les alias exportés.

        Obligatoire ?                false
        Position ?                   named
        Valeur par défaut
        Accepter l'entrée de pipeline ?       false
        Accepter les caractères génériques ?  true

    -ArgumentList <Object[]>
        Spécifie les arguments (valeurs de paramètre) passés à un module de script pendant l'exécution de la commande Import-Module.  Ce paramètre est valide uniquement lorsque vous importez un module de script.

        Vous pouvez également faire référence à ArgumentList en utilisant son alias, « args ». Pour plus d'informations, consultez about_Aliases.

        Obligatoire ?                false
        Position ?                   named
        Valeur par défaut
        Accepter l'entrée de pipeline ?       false
        Accepter les caractères génériques ?  false

    -AsCustomObject [<SwitchParameter>]
        Retourne un objet personnalisé avec des membres qui représentent les membres de module importés. Ce paramètre est uniquement valide pour les modules de script.

        Lorsque vous utilisez le paramètre AsCustomObject, Import-Module importe les membres de module dans la session, puis retourne un objet PSCustomObject au lieu d'un objet PSModuleInfo. Vous pouvez enregistrer l'objet personnalisé dans une variable et utiliser la notation par points pour appeler les membres.

        Obligatoire ?                false
        Position ?                   named
        Valeur par défaut
        Accepter l'entrée de pipeline ?       false
        Accepter les caractères génériques ?  false

    -Assembly <Assembly[]>
        Importe les applets de commande et fournisseurs implémentés dans les objets Assembly spécifiés. Entrez une variable qui contient les objets Assembly ou tapez une commande qui crée ces objets. Vous pouvez également diriger un objet Assembly vers Import-Module.

        Lorsque vous utilisez ce paramètre, seuls les applets de commande et fournisseurs implémentés par les assemblys spécifiés sont importés. Si le module contient d'autres fichiers, ils ne sont pas importés et des membres importants du module peuvent être manquants. Utilisez ce paramètre pour le débogage et le test du module, ou lorsque l'auteur du module vous conseille de l'utiliser.

        Obligatoire ?                true
        Position ?                   1
        Valeur par défaut
        Accepter l'entrée de pipeline ?       true (ByValue)
        Accepter les caractères génériques ?  false

    -Cmdlet <string[]>
        Importe uniquement les applets de commande spécifiées à partir du module dans la session active. Entrez une liste d'applets de commande. Les caractères génériques sont autorisés.

        Certains modules exportent automatiquement certaines applets de commande dans votre session lorsque vous importez le module. Ce paramètre vous permet d'effectuer une sélection parmi les applets de commande exportées.

        Obligatoire ?                false
        Position ?                   named
        Valeur par défaut
        Accepter l'entrée de pipeline ?       false
        Accepter les caractères génériques ?  true

    -Force [<SwitchParameter>]
        Réimporte un module et ses membres, même si le mode d'accès du module ou de ses membres est en lecture seule.

        Obligatoire ?                false
        Position ?                   named
        Valeur par défaut                     False
        Accepter l'entrée de pipeline ?       false
        Accepter les caractères génériques ?  false

    -Function <string[]>
        Importe uniquement les fonctions spécifiées à partir du module dans la session active. Entrez une liste de fonctions. Les caractères génériques sont autorisés.

        Certains modules exportent automatiquement certaines fonctions dans votre session lorsque vous importez le module. Ce paramètre vous permet d'effectuer une sélection parmi les fonctions exportées.

        Obligatoire ?                false
        Position ?                   named
        Valeur par défaut
        Accepter l'entrée de pipeline ?       false
        Accepter les caractères génériques ?  true

    -Global [<SwitchParameter>]
        Lorsque ce paramètre est utilisé dans un module de script (.psm1), il importe des modules dans l'état de session global.

        Ce paramètre s'applique uniquement lorsqu'il s'affiche dans un module de script. Sinon, il est ignoré.

        Par défaut, les commandes d'un module de script, notamment les commandes de modules imbriqués, sont importées dans l'état de session de l'appelant. Pour restreindre les commandes exportées par un module, utilisez une commande Export-ModuleMember dans le module de script.

        Obligatoire ?                false
        Position ?                   named
        Valeur par défaut
        Accepter l'entrée de pipeline ?       false
        Accepter les caractères génériques ?  false

    -ModuleInfo <PSModuleInfo[]>
        Spécifie des objets de module à importer. Entrez une variable qui contient les objets de module ou tapez une commande qui obtient les objets de module, comme « get-module -listavailable ». Vous pouvez également diriger des  objets de module vers Import-Module.

        Obligatoire ?                true
        Position ?                   1
        Valeur par défaut
        Accepter l'entrée de pipeline ?       true (ByValue)
        Accepter les caractères génériques ?  false

    -Name <string[]>
        Spécifie les noms des modules à importer. Entrez le nom du module ou d'un fichier du module, tel qu'un fichier .psd1, .psm1, .dll ou ps1. Les chemins d'accès de fichier sont facultatifs. Les caractères génériques ne sont pas autorisés. Vous pouvez également diriger des noms de modules et des noms de fichiers vers Import-Module.

        Si vous omettez un chemin d'accès, Import-Module recherche le module dans les chemins d'accès enregistrés dans la variable d'environnement PSModulePath ($env:PSModulePath).

        Spécifiez uniquement le nom du module dans la mesure du possible. Lorsque vous spécifiez un nom de fichier, seuls les membres implémentés dans ce fichier sont importés. Si le module contient d'autres fichiers, ils ne sont pas importés et des membres importants du module peuvent être manquants.

        Obligatoire ?                true
        Position ?                   1
        Valeur par défaut
        Accepter l'entrée de pipeline ?       true (ByValue)
        Accepter les caractères génériques ?  false

    -PassThru [<SwitchParameter>]
        Retourne des objets qui représentent les modules importés. Par défaut, cette applet de commande ne génère aucune sortie.

        Remarques
        -- Lorsque vous dirigez la sortie d'une commande « get-module listavailable » vers une commande Import-Module avec le paramètre PassThru, Import-Module retourne l'objet que Get-Module lui a passé sans le mettre à jour. En conséquence, les propriétés Exported et NestedModules ne sont pas encore remplies.

        -- Lorsque vous utilisez le paramètre Prefix pour spécifier un préfixe pour le membre, le préfixe n'apparaît pas parmi les noms de membres dans les propriétés de l'objet de module. L'objet enregistre ce qui a été exporté avant que le préfixe ne soit appliqué.

        Obligatoire ?                false
        Position ?                   named
        Valeur par défaut
        Accepter l'entrée de pipeline ?       false
        Accepter les caractères génériques ?  false

    -Prefix <string>
        Ajoute le préfixe spécifié aux noms des membres de module importés.

        Utilisez ce paramètre pour éviter les conflits de noms qui peuvent se produire lorsque différents membres de la session ont le même nom. Ce paramètre ne modifie pas le module et n'affecte pas les fichiers que le module importe pour sa propre utilisation (appelés « modules imbriqués »). Il affecte seulement les noms de membres dans la session active.

        Par exemple, si vous spécifiez le préfixe « UTC », puis importez une applet de commande Get-Date, l'applet de commande est connue dans la session comme Get-UTCDate et n'est pas confondue avec l'applet de commande Get-Date d'origine.

        Obligatoire ?                false
        Position ?                   named
        Valeur par défaut
        Accepter l'entrée de pipeline ?       false
        Accepter les caractères génériques ?  false

    -Variable <string[]>
        Importe uniquement les variables spécifiées à partir du module dans la session active. Entrez une liste de variables. Les caractères génériques sont autorisés.

        Certains modules exportent automatiquement certaines variables dans votre session lorsque vous importez le module. Ce paramètre vous permet d'effectuer une sélection parmi les variables exportées.

        Obligatoire ?                false
        Position ?                   named
        Valeur par défaut
        Accepter l'entrée de pipeline ?       false
        Accepter les caractères génériques ?  true

    -Version <Version>
        Spécifie la version du module à importer. Utilisez ce paramètre lorsque vous avez des versions différentes du même module sur votre système.

        Obligatoire ?                false
        Position ?                   named
        Valeur par défaut
        Accepter l'entrée de pipeline ?       false
        Accepter les caractères génériques ?  false

    <CommonParameters>
        Cette applet de commande prend en charge les paramètres courants : Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer et OutVariable. Pour plus d'informations, tapez
        « get-help about_commonparameters ».

ENTRÉES
    System.String, System.Management.Automation.PSModuleInfo, System.Reflection.Assembly
        Vous pouvez diriger un nom de module, un objet de module ou un objet Assembly vers Import-Module.


SORTIES
    Aucun, System.Management.Automation.PSModuleInfo ou System.Management.Automation.PSCustomObject
        Par défaut, Import-Module ne génère pas de sortie. Si vous utilisez le paramètre PassThru, il génère un objet System.Management.Automation.PSModuleInfo qui représente le module. Si vous employez le paramètre AsCustomObject, il génère un objet PSCustomObject.


NOTES


        Vous pouvez également faire référence à Import-Module par son alias, « ipmo ». Pour plus d'informations, consultez about_Aliases.

        Pour pouvoir importer un module, vous devez copier le répertoire du module dans un répertoire accessible à votre ordinateur local. Pour plus d'informations, consultez about_Modules.

        Les membres de module s'exécutant dans leur propre état de session de module privé, les commandes qu'ils utilisent pour le traitement interne n'affectent pas votre état de session.

        Si vous importez des membres de nom et de type identiques dans votre session, Windows PowerShell utilise le membre importé en dernier par défaut. Les variables et alias sont remplacés, et les originaux ne sont pas accessibles. Les fonctions, applets de commande et fournisseurs sont simplement « masqués » par les nouveaux membres, et vous pouvez y accéder en qualifiant le nom de la commande avec le nom de son composant logiciel enfichable, module ou chemin de fonction.

        Pour mettre à jour les données de mise en forme des commandes importées à partir d'un module, utilisez l'applet de commande Update-FormatData. Update-FormatData met à jour également les données de mise en forme des commandes de la session qui ont été importées à partir des modules. Si le fichier de mise en forme d'un module change, vous pouvez exécuter une commande Update-FormatData pour mettre à jour les données de mise en forme des commandes importées. Vous n'avez pas besoin de réimporter le module.

        Pour que vous puissiez importer un module créé par Import-PSSession ou Export-PSSession, la stratégie d'exécution de la session active ne peut pas être Restricted ou AllSigned car les modules créés par Import-PSSession et Export-PSSession contiennent des fichiers de script non signés interdits par ces stratégies. Pour employer Import-Module sans modifier la stratégie d'exécution de l'ordinateur local, utilisez le paramètre Scope de Set-ExecutionPolicy afin de définir une stratégie d'exécution moins restrictive pour un processus unique.


    -------------------------- EXEMPLE 1 --------------------------

    C:\PS>import-module -name BitsTransfer


    Description
    -----------
    Cette commande importe les membres du module BitsTransfer dans la session active.

    Le nom de paramètre Name (-Name) est facultatif et peut être omis.

    Par défaut, Import-Module ne génère pas de sortie lorsqu'il importe un module. Pour demander une sortie, utilisez le paramètre PassThru ou AsCustomObject, ou bien le paramètre courant Verbose.





    -------------------------- EXEMPLE 2 --------------------------

    C:\PS>get-module -listAvailable | import-module


    Description
    -----------
    Cette commande importe tous les modules disponibles dans le chemin d'accès spécifié par la variable d'environnement PSModulePath ($env:psmodulepath) dans la session active.





    -------------------------- EXEMPLE 3 --------------------------

    C:\PS>$m = get-module -ListAvailable BitsTransfer, ServerBackup

    C:\PS> import-module -moduleInfo $m


    Description
    -----------
    Ces commandes importent les membres des modules BitsTransfer et ServerBackup dans la session active.

    La première commande utilise l'applet de commande Get-Module pour obtenir des objets PSModuleInfo qui représentent les modules BitsTransfer et ServerBackup. Elle enregistre les objets dans la variable $m. Le paramètre ListAvailable est obligatoire lorsque vous obtenez des modules qui ne sont pas encore importés dans la session.

    La deuxième commande utilise le paramètre ModuleInfo de Import-Module pour importer les modules dans la session active.

    Ces commandes reviennent à utiliser un opérateur de pipeline (|) pour envoyer la sortie d'une commande Get-Module vers Import-Module.





    -------------------------- EXEMPLE 4 --------------------------

    C:\PS>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-parm'.
    VERBOSE: Exporting function 'get-spec'.
    VERBOSE: Exporting function 'get-specDetails'.


    Description
    -----------
    Cette commande utilise un chemin d'accès explicite pour identifier le module à importer.

    Elle utilise également le paramètre courant Verbose pour obtenir une liste des éléments importés à partir du module. Sans le paramètre Verbose, PassThru ou AsCustomObject, Import-Module ne génère pas de sortie lors de l'importation d'un module.





    -------------------------- EXEMPLE 5 --------------------------

    C:\PS>import-module BitsTransfer -cmdlet Add-BitsTransferFile, Get-BitsTransfer

    C:\PS> get-module BitsTransfer

    Name              : BitsTransfer
    Path              : C:\Windows\system32\WindowsPowerShell\v1.0\Modules\BitsTransfer\BitsTransfer.psd1
    Description       :
    Guid              : 8fa5064b-8479-4c5c-86ea-0d311fe48875
    Version           : 1.0.0.0
    ModuleBase        : C:\Windows\system32\WindowsPowerShell\v1.0\Modules\BitsTransfer
    ModuleType        : Manifest
    PrivateData       :
    AccessMode        : ReadWrite
    ExportedAliases   : {}
    ExportedCmdlets   : {[Add-BitsTransfer, Add-BitsTransfer], [Complete-BitsTransfer, Complete-BitsTransfer], [Get-Bit
    sTransfer, Get-BitsTransfer], [Rem
                        ove-BitsTransfer, Remove-BitsTransfer]...}
    ExportedFunctions : {}
    ExportedVariables : {}
    NestedModules     : {Microsoft.BackgroundIntelligentTransfer.Management}


    C:\PS> get-command -module BitsTransfer

    CommandType Name                Definition
    ----------- ----                ----------
    Cmdlet      Add-BitsTransfer    Add-BitsTransfer [-BitsJob] <BitsJob[]> [-Source] <String[]> [[-Destination] <String[]>] [-Verbose] [-Debug] [-ErrorA...
    Cmdlet      Get-BitsTransfer    Get-BitsTransfer [[-Name] <String[]>] [-AllUsers] [-Verbose] [-Debug] [-ErrorAction<ActionPreference>] [-WarningActi...


    Description
    -----------
    Cet exemple indique comment restreindre les membres de module qui sont importés dans la session et l'effet de cette commande sur la session.

    La première commande importe uniquement les applets de commande Add-BitsTransfer et Get-BitsTransfer à partir du module BitsTransfer. Elle utilise le paramètre Cmdlet pour restreindre les applets de commande importées par le module. Vous pouvez également employer les paramètres Alias, Variable et Function pour restreindre d'autres membres importés par un module.

    La deuxième commande utilise l'applet de commande Get-Module pour obtenir l'objet qui représente le module BitsTransfer. 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.

    La troisième commande utilise le paramètre Module de l'applet de commande Get-Command pour obtenir les commandes importées à partir du module BitsTransfer. Les résultats confirment que seules les applets de commande Add-BitsTransfer et Get-BitsTransfer ont été importées.





    -------------------------- EXEMPLE 6 --------------------------

    C:\PS>import-module BitsTransfer -prefix PS -passthru

    Name              : bitstransfer
    Path              : C:\Windows\system32\WindowsPowerShell\v1.0\Modules\bitstransfer\bitstransfer.psd1
    Description       :
    Guid              : 8fa5064b-8479-4c5c-86ea-0d311fe48875
    Version           : 1.0.0.0
    ModuleBase        : C:\Windows\system32\WindowsPowerShell\v1.0\Modules\bitstransfer
    ModuleType        : Manifest
    PrivateData       :
    AccessMode        : ReadWrite
    ExportedAliases   : {}
    ExportedCmdlets   : {[Add-BitsTransfer, Add-BitsTransfer], [Remove-BitsTransfer, Remove-BitsTransfer], [Complete-Bi
    tsTransfer, Complete-BitsTransfer]
                        , [Get-BitsTransfer, Get-BitsTransfer]...}
    ExportedFunctions : {}
    ExportedVariables : {}
    NestedModules     : {Microsoft.BackgroundIntelligentTransfer.Management}


    C:\PS> get-command -module bitstransfer

    CommandType     Name                        Definition
    -----------     ----                        ----------
    Cmdlet          Add-PSBitsTransfer          Add-PSBitsTransfer [-BitsJob] <BitsJob[]> [-Source] <String[]> ...
    Cmdlet          Complete-PSBitsTransfer     Complete-PSBitsTransfer [-BitsJob] <BitsJob[]> [-Verbose] [-Deb...
    Cmdlet          Get-PSBitsTransfer          Get-PSBitsTransfer [[-Name] <String[]>] [-AllUsers] [-Verbose] ...
    Cmdlet          Remove-PSBitsTransfer       Remove-PSBitsTransfer [-BitsJob] <BitsJob[]> [-Verbose] [-Debug...
    Cmdlet          Resume-PSBitsTransfer       Resume-PSBitsTransfer [-BitsJob] <BitsJob[]> [-Asynchronous] [-...
    Cmdlet          Set-PSBitsTransfer          Set-PSBitsTransfer [-BitsJob] <BitsJob[]> [-DisplayName <String...
    Cmdlet          Start-PSBitsTransfer        Start-PSBitsTransfer [[-Source] <String[]>] [[-Destination] <St...
    Cmdlet          Suspend-PSBitsTransfer      Suspend-PSBitsTransfer [-BitsJob] <BitsJob[]> [-Verbose] [-Debu...


    Description
    -----------
    Ces commandes importent le module BitsTransfer dans la session active, ajoutent un préfixe aux noms de membres, puis affichent les noms de membres comportant un préfixe.

    La première commande utilise l'applet de commande Import-Module pour importer le module BitsTransfer. Elle utilise le paramètre Prefix pour ajouter le préfixe PS à tous les membres importés à partir du module et le paramètre PassThru pour retourner un objet de module qui représente le module importé.

    L'objet de module que la commande retourne comporte une propriété ExportedCmdlets qui répertorie les membres importés. Le préfixe n'apparaît pas dans les noms d'applets de commande car il s'applique après que les membres sont exportés (mais avant qu'ils soient importés).

    La deuxième commande utilise l'applet de commande Get-Command pour obtenir les membres importés à partir du module.
     Elle utilise le paramètre Module pour spécifier le module. La sortie montre que les membres de module ont un préfixe correct.

    Le préfixe que vous utilisez s'applique uniquement aux membres de la session active. Il ne modifie pas le module.





    -------------------------- EXEMPLE 7 --------------------------

    C:\PS>get-module -list | format-table -property name, moduletype -auto

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

    C:\PS> $a = import-module -name Show-Calendar -asCustomObject

    C:\PS> $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();

    C:\PS> $a."show-calendar"()


    Description
    -----------
    Ces commandes montrent comment obtenir et utiliser l'objet personnalisé qui est retourné par Import-Module.

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

    Les objets personnalisés sont très utiles pour l'écriture de scripts. Ils sont également utiles lorsque plusieurs objets importés ont les mêmes noms. L'utilisation de la méthode de script d'un objet équivaut à spécifier le nom complet d'un membre importé, y compris son nom de module.

    Le paramètre AsCustomObject peut être utilisé uniquement avec un module de script, ce qui fait que la première tâche consiste à déterminer lequel des modules disponibles est un module de script.

    La première commande utilise l'applet de commande Get-Module pour obtenir les modules disponibles. Elle utilise un opérateur de pipeline (|) pour passer les objets de module à l'applet de commande Format-Table, qui répertorie les ; propriétés Name et ModuleType de chaque module dans une table.

    La deuxième commande utilise l'applet de commande Import-Module pour importer le module de script Show-Calendar. Elle utilise le paramètre AsCustomObject pour demander un objet personnalisé. Elle enregistre l'objet personnalisé résultant dans la variable $a.

    La troisième commande utilise un opérateur de pipeline pour envoyer la variable $a à l'applet de commande Get-Member, qui obtient les propriétés et méthodes du PSCustomObject dans $a. La sortie affiche une méthode de script Show-Calendar.

    La dernière commande utilise la méthode de script Show-Calendar. Le nom de méthode doit être placé entre guillemets, parce qu'il inclut un trait d'union.





    -------------------------- EXEMPLE 8 --------------------------

    C:\PS>import-module BitsTransfer

    C:\PS> import-module BitsTransfer -force -prefix PS


    Description
    -----------
    Cet exemple indique comment utiliser le paramètre Force de l'applet de commande Import-Module lorsque vous réimportez un module dans la même session.

    La première commande importe le module BitsTransfer. La deuxième commande réimporte le module, cette fois à l'aide du paramètre Prefix.

    La deuxième commande inclut également le paramètre Force, qui supprime le module, puis le réimporte. Sans ce paramètre, la session inclurait deux copies de chaque applet de commande BitsTransfer, une avec le nom standard et une autre avec le nom préfixé.





    -------------------------- EXEMPLE 9 --------------------------

    C:\PS>get-date

    Saturday, September 12, 2009 6:47:04 PM

    C:\PS> import-module TestModule

    C:\PS> get-date
    09255

    C:\PS> get-command get-date | format-table -property commandtype, name, pssnapin, module -auto

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


    C:\PS> Microsoft.PowerShell.Utility\get-date

    Saturday, September 12, 2009 6:33:23 PM


    Description
    -----------
    Cet exemple indique comment exécuter des commandes masquées par des commandes importées.

    La première commande exécute l'applet de commande Get-Date fournie avec Windows PowerShell. Elle retourne un objet DateTime avec la date actuelle.

    La deuxième commande importe le module TestModule. Ce module inclut une fonction nommée Get-Date qui retourne la date julienne.

    La troisième commande réexécute la commande Get-Date. Étant donné que les fonctions sont prioritaires sur les applets de commande, la fonction Get-Date du module TestModule a été exécutée, au lieu de l'applet de commande Get-Date.

    La quatrième commande indique que la session comporte deux commandes Get-Date, une fonction du module TestModule et une applet de commande du composant logiciel enfichable Microsoft.PowerShell.Utility.

    La cinquième commande exécute l'applet de commande masquée en qualifiant le nom de commande avec le nom de composant logiciel enfichable.

    Pour plus d'informations sur la précédence des commandes dans Windows PowerShell, consultez about_command_precedence.






LIENS CONNEXES
    Online version: http://go.microsoft.com/fwlink/?LinkID=141553
    Get-Module
    New-Module
    Remove-Module
    Export-ModuleMember
    about_Modules

Aucun commentaire:

Enregistrer un commentaire