Dela via

Add-PSSnapin

  • Referens
Modul:
Microsoft.PowerShell.Core

Lägger till en eller flera Windows PowerShell-snapin-moduler i den aktuella sessionen.

Syntax

Add-PSSnapin
   [-Name] <String[]>
   [-PassThru]
   [<CommonParameters>]

Description

Cmdleten Add-PSSnapin lägger till registrerade Windows PowerShell-snapin-moduler i den aktuella sessionen. När snapin-modulerna har lagts till kan du använda de cmdletar och leverantörer som snapin-modulerna stöder i den aktuella sessionen.

Om du vill lägga till snapin-modulen i alla framtida Windows PowerShell-sessioner lägger du till ett Add-PSSnapin--kommando i din Windows PowerShell-profil. Mer information finns i about_Profiles.

Från och med Windows PowerShell 3.0 paketeras de kärnkommandon som ingår i Windows PowerShell i moduler. Undantaget är Microsoft.PowerShell.Core, som är en snapin-modul (PSSnapin). Som standard läggs endast Microsoft.PowerShell.Core snapin-modul till i sessionen. Moduler importeras automatiskt vid första användningen och du kan använda cmdleten Import-Module för att importera dem.

Exempel

Exempel 1: Lägga till snapin-moduler

PS C:\> Add-PSSnapIn -Name Microsoft.Exchange, Microsoft.Windows.AD

Det här kommandot lägger till snapin-modulerna Microsoft Exchange och Active Directory i den aktuella sessionen.

Exempel 2: Lägg till alla registrerade snapin-moduler

PS C:\> Get-PSSnapin -Registered | Add-PSSnapin -Passthru

Det här kommandot lägger till alla registrerade Windows PowerShell-snapin-moduler i sessionen. Den använder cmdleten Get-PSSnapin med parametern Registered för att hämta objekt som representerar var och en av de registrerade snapin-modulerna. Pipelineoperatorn (|) skickar resultatet till Add-PSSnapin, som lägger till dem i sessionen. Parametern PassThru returnerar objekt som representerar var och en av de tillagda snapin-modulerna.

Exempel 3: Registrera en snapin-modul och lägg till den

The first command gets snap-ins that have been added to the current session that include the snap-ins that are installed with Windows PowerShell. In this example, ManagementFeatures is not returned. This indicates that it has not been added to the session.
PS C:\> Get-PSSnapin

The second command gets snap-ins that have been registered on your system, which includes those that have already been added to the session. It does not include the snap-ins that are installed with Windows PowerShell. In this case, the command does not return any snap-ins. This indicates that the ManagementFeatures snapin has not been registered on the system.
PS C:\> Get-PSSnapin -Registered

The third command creates an alias, installutil, for the path of the InstallUtil tool in .NET Framework.
PS C:\> Set-Alias installutil $env:windir\Microsoft.NET\Framework\v2.0.50727\installutil.exe

The fourth command uses the InstallUtil tool to register the snap-in. The command specifies the path of ManagementCmdlets.dll, the file name or module name of the snap-in.
PS C:\> installutil C:\Dev\Management\ManagementCmdlets.dll

The fifth command is the same as the second command. This time, you use it to verify that the ManagementCmdlets snap-in is registered.
PS C:\> Get-PSSnapin -Registered

The sixth command uses the **Add-PSSnapin** cmdlet to add the ManagementFeatures snap-in to the session. It specifies the name of the snap-in, ManagementFeatures, not the file name.
PS C:\> add-pssnapin ManagementFeatures

To verify that the snap-in is added to the session, the seventh command uses the *Module* parameter of the Get-Command cmdlet. It displays the items that were added to the session by a snap-in or module.
PS C:\> Get-Command -Module ManagementFeatures

You can also use the **PSSnapin** property of the object that the **Get-Command** cmdlet returns to find the snap-in or module in which a cmdlet originated. The eighth command uses dot notation to find the value of the PSSnapin property of the Set-Alias cmdlet.
PS C:\> (Get-Command Set-Alias).pssnapin

Det här exemplet visar processen att registrera en snapin-modul i systemet och sedan lägga till den i sessionen. Den använder ManagementFeatures, en fiktiv snapin-modul som implementeras i en fil med namnet ManagementCmdlets.dll.

Parametrar

-Name

Anger namnet på snapin-modulen. Det här är Namnet, inte AssemblyName eller ModuleName. Jokertecken tillåts.

Om du vill hitta namnen på de registrerade snapin-modulerna i systemet skriver du Get-PSSnapin -Registered.

Typ:String[]
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-PassThru

Anger att den här cmdleten returnerar ett objekt som representerar varje snapin-modul som har lagts till. Som standard genererar den här cmdleten inga utdata.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

None

Du kan inte skicka objekt till den här cmdleten.

Utdata

None or System.Management.Automation.PSSnapInInfo

Den här cmdleten returnerar ett PSSnapInInfo-objekt som representerar snapin-modulen om du anger parametern PassThru. Annars genererar den här cmdleten inga utdata.

Kommentarer

  • Från och med Windows PowerShell 3.0 paketeras de kärnkommandon som installeras med Windows PowerShell i moduler. I Windows PowerShell 2.0 och i värdprogram som skapar äldre sessioner i senare versioner av Windows PowerShell paketeras kärnkommandona i snapin-moduler (PSSnapins). Undantaget är Microsoft.PowerShell.Core, som alltid är en snapin-modul. Fjärrsessioner, till exempel de som startas av cmdleten New-PSSession, är också äldre sessioner som innehåller kärn snapin-moduler.

    Information om metoden CreateDefault2 som skapar nyare sessioner med kärnmoduler finns i CreateDefault2-metod i MSDN-biblioteket.

  • Mer information om snapin-moduler finns i about_PSSnapins och Så här skapar du en Windows PowerShell-snapin- i MSDN-biblioteket.

  • Add-PSSnapin lägger bara till snapin-modulen i den aktuella sessionen. Lägg till snapin-modulen i alla Windows PowerShell-sessioner genom att lägga till den i din Windows PowerShell-profil. Mer information finns i about_Profiles.

  • Du kan lägga till alla snapin-moduler som har registrerats med hjälp av microsoft .NET Framework-installationsverktyget. Mer information finns i Registrera cmdletar, providers och värdprogram i MSDN-biblioteket.

  • Om du vill hämta en lista över snapin-moduler som är registrerade på datorn skriver du Get-PSSnapin -Registered.

  • Innan du lägger till en snapin-modul kontrollerar Add-PSSnapin- versionen av snapin-modulen för att kontrollera att den är kompatibel med den aktuella versionen av Windows PowerShell. Om snapin-modulen misslyckas med versionskontrollen rapporterar Windows PowerShell ett fel.