Get-PSSnapin

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

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

Syntax

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

Description

L’applet Get-PSSnapin de commande obtient les composants logiciels enfichables Windows PowerShell qui ont été ajoutés à la session active ou qui ont été 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.

À 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 Import-Module de commande 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 qui sont actuellement chargés dans la session. Cela inclut les composants logiciels enfichables qui sont 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 qui ont été 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 qui sont installés avec Windows PowerShell ni les bibliothèques de liens dynamiques (DLL) de composants logiciels enfichables 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 carte sont autorisés.

Type:String[]
Position:0
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 qui sont 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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entrées

None

Vous ne pouvez pas diriger d'entrée vers cette applet de commande.

Sorties

PSSnapInInfo

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

Notes

Windows PowerShell inclut les alias suivants pour Get-PSSnapin:

  • gsnp

À 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 les composants logiciels enfichables (PSSnapin). L’exception est Microsoft.PowerShell.Core, qui est toujours un composant logiciel enfichable. En outre, les sessions distantes, telles que celles démarrées par l’applet New-PSSession de commande, 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écents avec des modules principaux, consultez La méthode CreateDefault2.