RUBRIQUE about_PSSnapins DESCRIPTION COURTE Décrit les composants logiciels enfichables Windows PowerShell et indique comment les utiliser et les gérer. DESCRIPTION LONGUE Un composant logiciel enfichable Windows PowerShell est un assembly Microsoft .NET Framework qui contient des fournisseurs et/ou des applets de commande Windows PowerShell. Windows PowerShell inclut un jeu de composants logiciels enfichables de base, mais vous pouvez augmenter sa puissance et sa valeur en y ajoutant des composants logiciels enfichables contenant 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 fournisseurs qu'il contient sont immédiatement disponibles dans la session active, mais la modification affecte uniquement cette session. Pour ajouter le composant logiciel enfichable à toutes les sessions futures, enregistrez-le dans votre profil Windows PowerShell. Vous pouvez également utiliser l'applet de commande Export-Console pour enregistrer les noms de composant logiciel enfichable dans un fichier console, puis l'utiliser dans les futures sessions. Vous pouvez même enregistrer plusieurs fichiers consoles, chacun contenant un jeu différent de composants logiciels enfichables. COMPOSANTS LOGICIELS ENFICHABLES INTÉGRÉS Windows PowerShell inclut un jeu de composants logiciels enfichables qui contiennent les fournisseurs et applets de commande intégrés. Microsoft.PowerShell.Core Contient les fournisseurs et applets de commande utilisés pour gérer les fonctionnalités de base de Windows PowerShell. Inclut les fournisseurs FileSystem, Registry, Alias, Environment, Function et Variable, ainsi que des applets de commande de base telles que Get-Help, Get-Command et Get-History. Microsoft.PowerShell.Host Contient les applets de commande utilisées par l'hôte Windows PowerShell, telles que Start-Transcript et Stop-Transcript. Microsoft.PowerShell.Management Contient des applets de commande telles que Get-Service et Get-ChildItem, utilisées pour gérer les fonctionnalités Windows. Microsoft.PowerShell.Security Contient les applets de commande utilisées pour gérer la sécurité Windows PowerShell, telles que Get-Acl, Get-AuthenticodeSignature et ConvertTo-SecureString. Microsoft.PowerShell.Utility Contient les applets de commande utilisées pour manipuler des objets et des données, telles que Get-Member, Write-Host et Format-List. RECHERCHE DE COMPOSANTS LOGICIELS ENFICHABLES Pour obtenir une liste des composants logiciels enfichables Windows PowerShell sur votre ordinateur, tapez : get-pssnapin Pour obtenir le composant logiciel enfichable de chaque fournisseur Windows PowerShell, tapez : get-psprovider | format-list name, pssnapin Pour obtenir une liste des applets de commande d'un composant logiciel enfichable Windows PowerShell, tapez : get-command -module <nom_composant-logiciel-enfichable> INSTALLATION D'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 les composants logiciels enfichables que vous créez ou obtenez d'autres personnes, puis les ajouter à votre session. INSCRIPTION D'UN COMPOSANT LOGICIEL ENFICHABLE Un composant logiciel enfichable Windows PowerShell est un programme écrit en langage .NET Framework et compilé en fichier .dll. Pour utiliser les fournisseurs et applets de commande d'un composant logiciel enfichable, vous devez d'abord inscrire ce composant (l'ajouter au Registre). La plupart des composants logiciels enfichables incluent un programme d'installation (fichier .exe ou .msi) qui inscrit le fichier .dll pour vous. Toutefois, si vous recevez un composant logiciel enfichable sous forme de fichier .dll, vous pouvez l'inscrire sur votre système. Pour plus d'informations, consultez " How to Register Cmdlets, Providers, and Host Applications " (en anglais) dans la bibliothèque MSDN (Microsoft Developer Network) à l'adresse https://go.microsoft.com/fwlink/?LinkID=143619. Pour obtenir tous les composants logiciels enfichables inscrits sur votre système ou vérifier l'inscription d'un tel composant, tapez : get-pssnapin -registered AJOUT DU COMPOSANT LOGICIEL ENFICHABLE À LA SESSION ACTIVE Pour ajouter un composant logiciel enfichable inscrit à la session active, utilisez l'applet de commande Add-PsSnapin. Par exemple, pour ajouter le composant logiciel enfichable Microsoft SQL Server à la session, tapez : add-pssnapin sql Une fois la commande exécutée, les fournisseurs et applets de commande de ce composant logiciel enfichable seront disponibles dans la session. Toutefois, ils ne seront disponibles que dans la session active, à moins que vous ne les enregistriez. ENREGISTREMENT DES COMPOSANTS LOGICIELS ENFICHABLES Pour utiliser un composant logiciel enfichable dans les futures sessions Windows PowerShell, ajoutez la commande Add-PsSnapin à votre profil Windows PowerShell. Sinon, exportez les noms de composant logiciel enfichable vers un fichier console. Si vous ajoutez la commande Add-PSSnapin à votre profil, elle sera disponible dans toutes les futures sessions Windows PowerShell. Si vous exportez les noms des composants logiciels enfichables dans votre session, vous pouvez n'utiliser le fichier d'exportation que lorsque vous avez besoin des composants logiciels enfichables. Pour ajouter la commande Add-PsSnapin à 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 d'une session dans le fichier console (.psc1), utilisez l'applet de commande Export-Console. Par exemple, pour enregistrer les composants logiciels enfichables de la configuration de session active dans le fichier NewConsole.psc1 du répertoire actif, tapez : export-console NewConsole Pour plus d'informations, consultez Export-Console. OUVERTURE DE WINDOWS POWERSHELL AVEC UN FICHIER CONSOLE Pour utiliser un fichier console incluant le composant logiciel enfichable, démarrez Windows PowerShell (Powershell.exe) à partir de l'invite de commandes de Cmd.exe ou d'une autre session Windows PowerShell. Utilisez le paramètre PsConsoleFile pour spécifier le fichier console incluant le composant logiciel enfichable. Par exemple, la commande suivante démarre Windows PowerShell avec le fichier console NewConsole.psc1 : powershell.exe -psconsolefile NewConsole.psc1 Les fournisseurs et applets de commande du composant logiciel enfichable sont maintenant disponibles dans la session. SUPPRESSION D'UN COMPOSANT LOGICIEL ENFICHABLE Pour supprimer un composant logiciel enfichable Windows PowerShell de la session active, utilisez l'applet de commande Remove-PsSnapin. 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 applets de commande qu'il prend en charge ne sont plus disponibles. VOIR AUSSI Add-PsSnapin Get-PsSnapin Remove-PsSnapin Export-Console Get-Command about_Profiles