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