À propos de PSSnapins

Article
06/21/2023

DESCRIPTION COURTE

Décrit Windows PowerShell composants logiciels enfichables et montre comment les utiliser et les gérer.

DESCRIPTION DÉTAILLÉE

Un composant logiciel enfichable Windows PowerShell est un assembly Microsoft .NET Framework qui contient Windows PowerShell fournisseurs et/ou applets de commande. 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 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 de commande Export-Console pour enregistrer les noms du composant logiciel enfichable dans un fichier de console, puis l’utiliser dans des sessions ultérieures. Vous pouvez même enregistrer plusieurs fichiers console, chacun avec un ensemble différent de composants logiciels enfichables.

REMARQUE : les composants logiciels enfichables Windows PowerShell (PSSnapins) peuvent être utilisés dans Windows PowerShell 3.0 et Windows PowerShell 2.0. Ils peuvent être modifiés ou indisponibles dans les versions suivantes. Pour empaqueter les fournisseurs et applets de commande de Windows PowerShell, utilisez des modules. Pour plus d’informations sur la création de modules et la conversion de composants logiciels en modules en modules, consultez Écriture d’un module Windows PowerShell.

RECHERCHE DE COMPOSANTS LOGICIELS ENFICHABLES

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 la liste des applets de commande dans un composant logiciel enfichable Windows PowerShell, tapez :

Get-Command -Module <snap-in_name>

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, puis ajouter les composants logiciels enfichables à votre session.

INSCRIPTION D’UN COMPOSANT LOGICIEL ENFICHABLE

Un composant logiciel enfichable Windows PowerShell est un programme écrit dans un langage .NET Framework compilé dans un fichier .dll. Pour utiliser les fournisseurs et les applets de commande dans un composant logiciel enfichable, vous devez d’abord inscrire le composant logiciel enfichable (l’ajouter au Registre).

La plupart des composants logiciels enfichables incluent un programme d’installation (un fichier .exe ou .msi) qui inscrit le fichier .dll pour vous. Toutefois, si vous recevez un composant logiciel enfichable en tant que fichier .dll, vous pouvez l’inscrire sur votre système. Pour plus d’informations, consultez Inscription d’applets de commande, de fournisseurs et d’applications hôtes dans la bibliothèque MSDN.

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

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 terminée, les fournisseurs et les applets de commande dans le composant logiciel enfichable sont disponibles dans la session. Toutefois, ils sont disponibles uniquement dans la session active, sauf si vous les enregistrez.

ENREGISTREMENT DES COMPOSANTS LOGICIELS ENFICHABLES

Pour utiliser un composant logiciel enfichable dans les prochaines sessions Windows PowerShell, ajoutez la commande Add-PSSnapin à votre profil Windows PowerShell. Vous pouvez également exporter les noms du composant logiciel enfichable dans un fichier console.

Si vous ajoutez la commande Add-PSSnapin à votre profil, elle est disponible dans toutes les sessions Windows PowerShell ultérieures. 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 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_Providers.

Pour enregistrer les composants logiciels enfichables à partir 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 actuelle dans le fichier NewConsole.psc1 dans le 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 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 fichier console NewConsole.psc1 :

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.

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 les applets de commande qu’il prend en charge ne sont plus disponibles.

COMMANDES INTÉGRÉES

Dans Windows PowerShell 2.0 et dans les programmes hôtes de style plus ancien dans Windows PowerShell 3.0 et versions ultérieures, les commandes intégrées installées avec Windows PowerShell sont empaquetées dans des composants logiciels enfichables qui sont ajoutés automatiquement à chaque session Windows PowerShell.

À partir de Windows PowerShell 3.0, dans les programmes hôtes de style plus récent -- ceux qui démarrent des sessions à l’aide de la méthode InitialSessionState.CreateDefault2 -- les commandes intégrées sont empaquetées dans des modules. L’exception est Microsoft.PowerShell.Core, qui apparaît toujours sous forme de composant logiciel enfichable. Le composant logiciel enfichable Core est inclus dans chaque session par défaut. Les modules intégrés sont chargés automatiquement lors de la première utilisation.

REMARQUE : Les sessions distantes, y compris les sessions démarrées à l’aide de l’applet de commande New-PSSession, sont des sessions de style plus ancien dans lesquelles les commandes intégrées sont empaquetées dans des composants logiciels enfichables.

Les composants logiciels enfichables (ou modules) suivants sont installés avec Windows PowerShell.

Microsoft.PowerShell.Core : contient les fournisseurs et les applets de commande utilisés pour gérer les fonctionnalités de base de Windows PowerShell. Il 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 qui sont utilisées pour gérer les fonctionnalités Windows.
Microsoft.PowerShell.Security : contient le fournisseur de certificats et les applets de commande utilisés pour gérer Windows PowerShell sécurité, telles que Get-Acl, Get-AuthenticodeSignature et ConvertTo-SecureString.
Microsoft.PowerShell.Utility : contient des applets de commande utilisées pour manipuler des objets et des données, tels que Get-Member, Write-Host et Format-List.
Microsoft.WSMan.Management : contient le fournisseur WSMan et les applets de commande qui gèrent le service De gestion à distance Windows, comme Connect-WSMan et Enable-WSManCredSSP.

JOURNALISATION DES ÉVÉNEMENTS DE COMPOSANT LOGICIEL ENFICHABLE

À compter de Windows PowerShell 3.0, vous pouvez enregistrer les événements d’exécution des applets de commande dans les modules et les composants logiciels enfichables Windows PowerShell en définissant la propriété LogPipelineExecutionDetails des modules et des composants logiciels enfichables sur TRUE. Pour plus d’informations, consultez about_EventLogs.