about_PSSnapins
Description courte
Décrit les composants logiciels enfichables Windows PowerShell et montre comment les utiliser et les gérer.
Description longue
Un composant logiciel enfichable Windows PowerShell est un assembly Microsoft .NET Framework qui peut contenir des fournisseurs et des applets de commande Windows PowerShell. Windows PowerShell inclut un ensemble de composants logiciels enfichables de base, mais vous pouvez étendre la puissance et la valeur de Windows PowerShell en ajoutant des composants logiciels enfichables qui contiennent des fournisseurs et des applets de commande que vous créez ou obtenez d’autres personnes.
Lorsque vous ajoutez un composant logiciel enfichable, les applets de commande et les fournisseurs qu’il contient sont immédiatement disponibles pour une utilisation dans la session active, mais la modification affecte uniquement la session active.
Pour ajouter le composant logiciel enfichable à toutes les sessions futures, enregistrez-le dans votre profil Windows PowerShell. Vous pouvez également utiliser l’applet Export-Console de commande pour enregistrer les noms de composants logiciels enfichables dans un fichier console, puis utiliser cette configuration enregistrée dans les sessions ultérieures.
À compter de Windows PowerShell 3.0, les applets de commande fournies avec PowerShell sont empaquetées dans les modules. L’exception est Microsoft.PowerShell.Core, qui est le seul composant logiciel enfichable restant. Le composant logiciel enfichable Microsoft.PowerShell.Core est chargé par défaut dans chaque session. Les modules restants sont chargés automatiquement lors de la première utilisation. Pour plus d’informations, consultez about_Modules.
Rechercher un composant logiciel enfichable
Pour obtenir la liste des composants logiciels enfichables Windows PowerShell sur votre ordinateur, tapez :
Get-PSSnapin
Pour obtenir le composant logiciel enfichable pour chaque fournisseur Windows PowerShell, tapez :
Get-PSProvider | Format-List name, pssnapin
Pour obtenir tous les composants logiciels enfichables inscrits sur votre système ou vérifier qu’un composant logiciel enfichable est inscrit, tapez :
Get-PSSnapin -registered
Pour obtenir la liste des applets de commande dans un composant logiciel enfichable Windows PowerShell, tapez :
Get-Command -Module <snap-in_name>
Installer un composant logiciel enfichable
Les composants logiciels enfichables intégrés sont inscrits dans le système et ajoutés à la session par défaut lorsque vous démarrez Windows PowerShell. Toutefois, vous devez inscrire des composants logiciels enfichables que vous créez ou obtenez d’autres personnes, puis ajouter les composants logiciels enfichables à votre session.
Ajouter un composant logiciel enfichable à la session active
Pour ajouter un composant logiciel enfichable inscrit à la session active, utilisez l’applet de Add-PsSnapin commande. Par exemple, pour ajouter le composant logiciel enfichable Microsoft SQL Server à la session, tapez :
Add-PSSnapin sql
Une fois la commande terminée, les fournisseurs et les applets de commande du composant logiciel enfichable sont disponibles dans la session. Toutefois, ils sont disponibles uniquement dans la session active, sauf si vous les enregistrez.
Enregistrer des composants logiciels enfichables
Pour utiliser un composant logiciel enfichable dans les futures sessions Windows PowerShell, ajoutez la Add-PsSnapin commande à votre profil Windows PowerShell. Vous pouvez également exporter les noms du composant logiciel enfichable dans un fichier console.
Si vous ajoutez la Add-PSSnapin commande à votre profil, elle est disponible dans toutes les futures sessions Windows PowerShell. Si vous exportez les noms des composants logiciels enfichables dans votre session, vous pouvez utiliser le fichier d’exportation uniquement lorsque vous avez besoin des composants logiciels enfichables.
Pour ajouter la Add-PsSnapin commande à votre profil Windows PowerShell, ouvrez votre profil, collez ou tapez la commande, puis enregistrez le profil. Pour plus d’informations, consultez about_Profiles.
Pour enregistrer les composants logiciels enfichables à partir d’une session dans le fichier console (.psc1), utilisez l’applet Export-Console de commande. Par exemple, pour enregistrer les composants logiciels enfichables dans la configuration de session active dans le NewConsole.psc1 fichier du répertoire actif, tapez :
Export-Console NewConsole
Pour plus d’informations, consultez Export-Console.
Ouvrir Windows PowerShell à l’aide d’un fichier console
Pour utiliser un fichier console qui inclut le composant logiciel enfichable, démarrez Windows PowerShell (powershell.exe) à partir de l’invite de commandes dans cmd.exe ou dans une autre session Windows PowerShell. Utilisez le paramètre PsConsoleFile pour spécifier le fichier console qui inclut le composant logiciel enfichable. Par exemple, la commande suivante démarre Windows PowerShell avec le NewConsole.psc1 fichier console :
PowerShell.exe -psconsolefile NewConsole.psc1
Les fournisseurs et les applets de commande du composant logiciel enfichable sont désormais disponibles pour une utilisation dans la session.
Supprimer un composant logiciel enfichable
Pour supprimer un composant logiciel enfichable Windows PowerShell de la session active, utilisez l’applet Remove-PsSnapin de commande. Par exemple, pour supprimer le composant logiciel enfichable SQL Server de la session active, tapez :
Remove-PSSnapin sql
Cette applet de commande supprime le composant logiciel enfichable de la session. Le composant logiciel enfichable est toujours chargé, mais les fournisseurs et les applets de commande qu’il prend en charge ne sont plus disponibles.
Journaux des événements enfichables
À compter de Windows PowerShell 3.0, vous pouvez enregistrer des événements d’exécution pour les applets de commande dans les modules Windows PowerShell et les composants logiciels enfichables en définissant la propriété LogPipelineExecutionDetails des modules et des composants logiciels enfichables $truesur .
Pour plus d’informations, consultez about_EventLogs.
