Partager via

Get-PSSnapin

  • Référence
Module:
Microsoft.PowerShell.Core

Obtient les composants logiciels enfichables Windows PowerShell sur l’ordinateur.

Syntaxe

Get-PSSnapin
   [[-Name] <String[]>]
   [-Registered]
   [<CommonParameters>]

Description

L’applet de commande Get-PSSnapin get-PSSnapin obtient les composants logiciels enfichables Windows PowerShell qui ont été ajoutés à la session active ou inscrits sur le système. Cette applet de commande répertorie les composants logiciels enfichables dans l’ordre dans lequel ils sont détectés.

Get-PSSnapin obtient uniquement les composants logiciels enfichables inscrits. Pour inscrire un composant logiciel enfichable Windows PowerShell, utilisez l’outil InstallUtil inclus dans Microsoft .NET Framework 2.0. Pour plus d’informations, consultez Comment inscrire des applets de commande, des fournisseurs et des applications hôtes dans la bibliothèque MSDN.

À compter de Windows PowerShell 3.0, les commandes principales incluses dans Windows PowerShell sont empaquetées dans les modules. L’exception est Microsoft.PowerShell.Core, qui est un composant logiciel enfichable (PSSnapin). Par défaut, seul le composant logiciel enfichable Microsoft.PowerShell.Core est ajouté à la session. Les modules sont importés automatiquement lors de la première utilisation et vous pouvez utiliser l’applet de commande Import-Module pour les importer.

Exemples

Exemple 1 : Obtenir des composants logiciels enfichables actuellement chargés

PS C:\> Get-PSSnapIn

Cette commande obtient les composants logiciels enfichables Windows PowerShell actuellement chargés dans la session. Cela inclut les composants logiciels enfichables installés avec Windows PowerShell et ceux qui ont été ajoutés à la session.

Exemple 2 : Obtenir des composants logiciels enfichables inscrits

PS C:\> get-PSSnapIn -Registered

Cette commande obtient les composants logiciels enfichables Windows PowerShell inscrits sur l’ordinateur, y compris ceux qui ont déjà été ajoutés à la session. La sortie n’inclut pas les composants logiciels enfichables installés avec Windows PowerShell ou les bibliothèques de liens dynamiques (DLL) windows PowerShell qui n’ont pas encore été inscrites sur le système.

Exemple 3 : Obtenir les composants logiciels enfichables actuels qui correspondent à une chaîne

PS C:\> Get-PSSnapIn -Name smp*

Cette commande obtient les composants logiciels enfichables Windows PowerShell dans la session active qui ont des noms qui commencent par smp.

Paramètres

-Name

Spécifie un tableau de noms de composants logiciels enfichables. Cette applet de commande obtient uniquement les composants logiciels enfichables Windows PowerShell spécifiés. Les caractères génériques sont autorisés.

Type:String[]
Position:0
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Registered

Indique que cette applet de commande obtient les composants logiciels enfichables Windows PowerShell inscrits sur le système, même s’ils n’ont pas encore été ajoutés à la session.

Les composants logiciels enfichables installés avec Windows PowerShell n’apparaissent pas dans cette liste.

Sans ce paramètre, Get-PSSnapin obtient les composants logiciels enfichables Windows PowerShell qui ont été ajoutés à la session.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

None

Vous ne pouvez pas diriger l’entrée vers cette applet de commande.

Sorties

PSSnapInInfo

Get-PSSnapin retourne un objet pour chaque composant logiciel enfichable qu’il obtient.

Notes

  • À compter de Windows PowerShell 3.0, les commandes principales installées avec Windows PowerShell sont empaquetées dans les modules. Dans Windows PowerShell 2.0 et dans les programmes hôtes qui créent des sessions de style plus ancien dans les versions ultérieures de Windows PowerShell, les commandes principales sont empaquetées dans des composants logiciels enfichables (PSSnapin). L’exception est Microsoft.PowerShell.Core, qui est toujours un composant logiciel enfichable. En outre, les sessions à distance, telles que celles démarrées par l’applet de commande New-PSSession, sont des sessions de style plus ancien qui incluent des composants logiciels enfichables principaux.

    Pour plus d’informations sur la méthode CreateDefault2 qui crée des sessions de style plus récent avec des modules principaux, consultez méthode CreateDefault2 dans la bibliothèque MSDN.