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 snapin-modulen Microsoft.PowerShell.Core 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, vilket 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

Det första kommandot hämtar snapin-moduler som har lagts till i den aktuella sessionen som innehåller snapin-modulerna som är installerade med Windows PowerShell. I det här exemplet returneras inte ManagementFeatures. Detta indikerar att den inte har lagts till i sessionen.

Det andra kommandot hämtar snapin-moduler som har registrerats i systemet, vilket inkluderar de som redan har lagts till i sessionen. Den innehåller inte de snapin-moduler som är installerade med Windows PowerShell. I det här fallet returnerar kommandot inga snapin-moduler. Detta anger att snapin-modulen ManagementFeatures inte har registrerats i systemet.

Det tredje kommandot skapar ett alias, installutil, för sökvägen till verktyget InstallUtil i .NET Framework.

Det fjärde kommandot använder verktyget InstallUtil för att registrera snapin-modulen. Kommandot anger sökvägen till ManagementCmdlets.dll, filnamn eller modulnamn för snapin-modulen.

Det femte kommandot är samma som det andra kommandot. Den här gången använder du den för att kontrollera att snapin-modulen ManagementCmdlets har registrerats.

Det sjätte kommandot använder cmdleten Add-PSSnapin för att lägga till snapin-modulen ManagementFeatures i sessionen. Den anger namnet på snapin-modulen ManagementFeatures, inte filnamnet.

För att verifiera att snapin-modulen har lagts till i sessionen använder det sjunde kommandot modulparametern för cmdleten Get-Command. Den visar de objekt som lades till i sessionen av en snapin-modul eller modul.

Du kan också använda pssnapin-egenskapen för objektet som cmdleten Get-Command returnerar för att hitta snapin-modulen eller modulen där en cmdlet har sitt ursprung. Det åttonde kommandot använder punkt notation för att hitta värdet för pssnapin-egenskapen för cmdleten Set-Alias.

PS C:\> Get-PSSnapin
PS C:\> Get-PSSnapin -Registered
PS C:\> Set-Alias installutil $env:windir\Microsoft.NET\Framework\v2.0.50727\installutil.exe
PS C:\> installutil C:\Dev\Management\ManagementCmdlets.dll
PS C:\> Get-PSSnapin -Registered
PS C:\> add-pssnapin ManagementFeatures
PS C:\> Get-Command -Module ManagementFeatures
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:True

-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

Windows PowerShell innehåller följande alias för Add-PSSnapin:

  • asnp

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-metoden.

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

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, leverantörer och värdprogram.

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 Add-PSSnapin kontrollerar du 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.