about_PSSnapins

Mis à jour: mai 2014

S'applique à: Windows PowerShell 2.0, Windows PowerShell 3.0, Windows PowerShell 4.0, Windows PowerShell 5.0

RUBRIQUE

about_PSSnapins

DESCRIPTION COURTE

Décrit les composants logiciels enfichables Windows PowerShell, et explique 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 rendre Windows PowerShell plus puissant et profitable en ajoutant des composants logiciels enfichables qui comportent des fournisseurs et des applets de commande que vous avez créés vous-même ou obtenus d'autres personnes.

Quand vous ajoutez un composant logiciel enfichable, les applets de commande et les fournisseurs qu'il contient sont disponibles immédiatement dans la session active. La modification s'applique uniquement à la session active.

Pour ajouter le composant logiciel enfichable à toutes les sessions ultérieures, 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 et l'utiliser dans les sessions ultérieures. Vous pouvez même enregistrer plusieurs fichiers console, chacun avec un ensemble différent de composants.

RECHERCHE DE COMPOSANTS LOGICIELS ENFICHABLES

Pour obtenir la liste de tous les composants logiciels enfichables Windows PowerShell installés sur votre ordinateur, tapez :

       get-pssnapin

Pour afficher le composant logiciel enfichable pour chaque fournisseur Windows PowerShell, tapez :

        get-psprovider | format-list name, pssnapin

Pour obtenir une liste des applets de commande contenues 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 quand vous démarrez Windows PowerShell. En revanche, vous devez inscrire les composants logiciels enfichables que vous avez créés ou obtenus d'autres personnes et les ajouter ensuite à votre session.

INSCRIPTION D'UN COMPOSANT LOGICIEL ENFICHABLE

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 contenus dans un composant logiciel enfichable, vous devez d'abord inscrire ce composant (c'est-à-dire l'ajouter au Registre).

La plupart des composants logiciels enfichables incluent un programme d'installation (sous forme de fichier .exe ou .msi) qui inscrit automatiquement le fichier .dll. Toutefois, si vous obtenez un composant logiciel enfichable compilé dans un fichier .dll, vous pouvez l'inscrire manuellement 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 (Microsoft Developer Network) à l'adresse https://go.microsoft.com/fwlink/?LinkID=143619.

Pour obtenir la liste de tous les composants logiciels enfichables inscrits sur votre système ou pour vérifier qu'un composant logiciel enfichable est inscrit, tapez :

       get-pssnapin -registered

AJOUT D'UN 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

Après l'exécution de la commande, les fournisseurs et les applets de commande contenus 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 DE COMPOSANTS LOGICIELS ENFICHABLES

Pour pouvoir utiliser un composant logiciel enfichable dans des sessions Windows PowerShell ultérieures, ajoutez la commande Add-PsSnapin à votre profil Windows PowerShell. Vous pouvez aussi exporter les noms de composant logiciel enfichable dans un fichier console.

Si vous ajoutez la commande Add-PSSnapin à votre profil, les composants logiciels enfichables seront disponibles 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 de ces composants.

Pour ajouter la commande Add-PsSnapin à votre profil Windows PowerShell, ouvrez le profil, copiez-collez ou tapez la commande dans le profil, puis enregistrez le profil. Pour plus d'informations, consultez about_Providers.

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 utilisés dans la configuration de la session active dans le fichier NewConsole.psc1 dans le répertoire actif, tapez :

Insérez le corps de la section ici.

       export-console NewConsole

Pour plus d'informations, consultez Export-Console.

OUVERTURE DE WINDOWS POWERSHELL AVEC UN FICHIER CONSOLE

Pour utiliser un fichier console contenant 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 contenant 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 contenus dans le 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 :Insérez le corps de la section ici.

       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 anciens programmes hôtes dans Windows PowerShell version 3.0 ou ultérieure, les commandes intégrées qui sont installées avec Windows PowerShell sont empaquetées dans des composants logiciels enfichables qui sont ajoutés automatiquement à chaque session Windows PowerShell.

Depuis Windows PowerShell 3.0, dans les nouveaux programmes hôtes, qui démarrent les sessions à l'aide de la méthode InitialSessionState.CreateDefault2, les commandes intégrées sont empaquetées dans des modules. Microsoft.PowerShell.Core fait figure d'exception, car il s'affiche toujours en tant que 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 à la première utilisation.

• Microsoft.PowerShell.Core
  Contient les fournisseurs et 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 les applets de commande comme Get-Service et Get-ChildItem qui sont utilisées pour gérer les fonctionnalités Windows.

• Microsoft.PowerShell.Security
  Contient le fournisseur Certificate et les applets de commande utilisées pour gérer la sécurité de Windows PowerShell, telles que Get-Acl, Get-AuthenticodeSignature et ConvertTo-SecureString.

• Microsoft.PowerShell.Utility
  Contient les applets de commande utilisées pour manipuler les objets et les données, telles 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 de Windows, telles que Connect-WSMan et Enable-WSManCredSSP.

JOURNALISATION DES ÉVÉNEMENTS LIÉS AUX COMPOSANTS LOGICIELS ENFICHABLES

À 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 affectant la valeur TRUE à la propriété LogPipelineExecutionDetails de ces modules et composants logiciels enfichables. Pour plus d’informations, consultez about_EventLogs (https://go.microsoft.com/fwlink/?LinkID=113224).

VOIR AUSSI

Add-PsSnapin

Get-PsSnapin

Remove-PsSnapin

Export-Console

Get-Command

about_Profiles

about_Modules

MOTS CLÉS : about_Snapins, about_Snap_ins, about_Snap-ins