À propos de PSSnapins

DESCRIPTION COURTE

Décrit les composants logiciels enfichables Windows PowerShell 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 des fournisseurs et/ou 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 de commande Export-Console pour enregistrer les noms des composants logiciels enfichables dans un fichier de console, puis l’utiliser dans les sessions ultérieures. Vous pouvez même enregistrer plusieurs fichiers de 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 ultérieures. Pour empaqueter les applets de commande et les fournisseurs Windows PowerShell, utilisez des modules. Pour plus d’informations sur la création de modules et la conversion de composants logiciels enfichables en modules, consultez Écriture d’un module Windows PowerShell.

TROUVER SNAP-INS

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 SNAP-IN

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.

ENREGISTREMENT D’UN SNAP-IN

Un composant logiciel enfichable Windows PowerShell est un programme écrit dans un langage .NET Framework qui est 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 enregistre le fichier .dll pour vous. Toutefois, si vous recevez un composant logiciel enfichable sous la forme d’un fichier .dll, vous pouvez l’enregistrer sur votre système. Pour plus d’informations, consultez Comment inscrire des applets de commande, des fournisseurs et des 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 SNAP-IN À LA SESSION EN COURS

Pour ajouter un composant logiciel enfichable enregistré à la session en cours, 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 du composant logiciel enfichable sont disponibles dans la session. Toutefois, ils ne sont disponibles que dans la session en cours, sauf si vous les enregistrez.

SAUVER LA SNAP-INS

Pour utiliser un composant logiciel enfichable dans les futures 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 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 de console (.psc1), utilisez l’applet de commande Export-Console. Par exemple, pour enregistrer les composants enfichables dans la configuration de session actuelle dans le fichier NewConsole.psc1 du répertoire actuel, tapez :

Export-Console NewConsole

Pour plus d’informations, consultez Export-Console.

OUVERTURE DE WINDOWS POWERSHELL À L’AIDE D’UN FICHIER DE CONSOLE

Pour utiliser un fichier de console qui inclut le composant logiciel enfichable, démarrez Windows PowerShell (PowerShell.exe) à partir de l’invite de commande dans Cmd.exe ou dans une autre session Windows PowerShell. Utilisez le paramètre PsConsoleFile pour spécifier le fichier de console qui inclut le composant logiciel enfichable. Par exemple, la commande suivante démarre Windows PowerShell avec le fichier de console NewConsole.psc1 :

PowerShell.exe -psconsolefile NewConsole.psc1

Les fournisseurs et les applets de commande du composant logiciel enfichable peuvent désormais être utilisés dans la session.

RETRAIT D’UN SNAP-IN

Pour supprimer un composant logiciel enfichable Windows PowerShell de la session en cours, 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.

BUILT-IN COMMANDES

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 la forme d’un composant logiciel enfichable. Par défaut, le composant logiciel enfichable Core est inclus dans chaque session. Les modules intégrés se chargent 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 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 les 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 la sécurité Windows PowerShell, tels 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, tels que Connect-WSMan et Enable-WSManCredSSP.

ENREGISTREMENT SNAP-IN ÉVÉNEMENTS

À compter de Windows PowerShell 3.0, vous pouvez enregistrer des événements d’exécution pour les 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.