Om PSSnapins

Artikel
06/21/2023

KORT BESKRIVNING

Beskriver Windows PowerShell snapin-moduler och visar hur du använder och hanterar dem.

LÅNG BESKRIVNING

En Windows PowerShell snapin-modul är en Microsoft .NET Framework-sammansättning som innehåller Windows PowerShell providers och/eller cmdletar. Windows PowerShell innehåller en uppsättning grundläggande snapin-moduler, men du kan utöka kraften och värdet för Windows PowerShell genom att lägga till snapin-moduler som innehåller providers och cmdletar som du skapar eller får från andra.

När du lägger till en snapin-modul är de cmdletar och leverantörer som den innehåller omedelbart tillgängliga för användning i den aktuella sessionen, men ändringen påverkar endast den aktuella sessionen.

Om du vill lägga till snapin-modulen i alla framtida sessioner sparar du den i din Windows PowerShell profil. Du kan också använda cmdleten Export-Console för att spara snapin-modulnamnen i en konsolfil och sedan använda den i framtida sessioner. Du kan till och med spara flera konsolfiler, var och en med olika uppsättning snapin-moduler.

Obs! Windows PowerShell snapin-moduler (PSSnapins) är tillgängliga för användning i Windows PowerShell 3.0 och Windows PowerShell 2.0. De kan ändras eller vara otillgängliga i efterföljande versioner. Om du vill paketera Windows PowerShell cmdletar och providers använder du moduler. Information om hur du skapar moduler och konverterar snapin-moduler till moduler finns i Skriva en Windows PowerShell-modul.

HITTA SNAPIN-MODULER

Om du vill hämta en lista över Windows PowerShell snapin-moduler på datorn skriver du:

Get-PSSnapin

Om du vill hämta snapin-modulen för varje Windows PowerShell-provider skriver du:

Get-PSProvider | Format-List name, pssnapin

Om du vill hämta en lista över cmdletarna i en Windows PowerShell snapin-modul skriver du:

Get-Command -Module <snap-in_name>

INSTALLERA EN SNAPIN-MODUL

De inbyggda snapin-modulerna registreras i systemet och läggs till i standardsessionen när du startar Windows PowerShell. Du måste dock registrera snapin-moduler som du skapar eller hämtar från andra och sedan lägga till snapin-modulerna i sessionen.

REGISTRERA EN SNAPIN-MODUL

En Windows PowerShell snapin-modul är ett program skrivet på ett .NET Framework språk som kompileras till en .dll fil. Om du vill använda providers och cmdletar i en snapin-modul måste du först registrera snapin-modulen (lägg till den i registret).

De flesta snapin-moduler innehåller ett installationsprogram (en .exe- eller .msi fil) som registrerar .dll filen åt dig. Men om du får en snapin-modul som en .dll fil kan du registrera den i systemet. Mer information finns i Registrera cmdletar, providers och värdprogram i MSDN-biblioteket.

Om du vill hämta alla registrerade snapin-moduler i systemet eller för att kontrollera att en snapin-modul har registrerats skriver du:

Get-PSSnapin -registered

LÄGGA TILL SNAPIN-MODULEN I DEN AKTUELLA SESSIONEN

Om du vill lägga till en registrerad snapin-modul i den aktuella sessionen använder du cmdleten Add-PSSnapin. Om du till exempel vill lägga till Snapin-modulen Microsoft SQL Server i sessionen skriver du:

Add-PSSnapin sql

När kommandot har slutförts är leverantörerna och cmdletarna i snapin-modulen tillgängliga i sessionen. De är dock endast tillgängliga i den aktuella sessionen om du inte sparar dem.

SPARA SNAPIN-MODULERNA

Om du vill använda en snapin-modul i framtida Windows PowerShell sessioner lägger du till kommandot Add-PSSnapin i din Windows PowerShell profil. Eller exportera snapin-modulnamnen till en konsolfil.

Om du lägger till kommandot Add-PSSnapin i din profil är det tillgängligt i alla kommande Windows PowerShell sessioner. Om du exporterar namnen på snapin-modulerna i sessionen kan du bara använda exportfilen när du behöver snapin-modulerna.

Om du vill lägga till kommandot Add-PSSnapin i din Windows PowerShell profil öppnar du din profil, klistrar in eller skriver kommandot och sparar sedan profilen. Mer information finns i about_Profiles.

Om du vill spara snapin-modulerna från en session i konsolfilen (.psc1) använder du cmdleten Export-Console. Om du till exempel vill spara snapin-modulerna i den aktuella sessionskonfigurationen i filen NewConsole.psc1 i den aktuella katalogen skriver du:

Export-Console NewConsole

Mer information finns i Export-Console.

ÖPPNA WINDOWS POWERSHELL MED EN KONSOLFIL

Om du vill använda en konsolfil som innehåller snapin-modulen startar du Windows PowerShell (PowerShell.exe) från kommandotolken i Cmd.exe eller i en annan Windows PowerShell session. Använd parametern PsConsoleFile för att ange den konsolfil som innehåller snapin-modulen. Följande kommando startar till exempel Windows PowerShell med konsolfilen NewConsole.psc1:

PowerShell.exe -psconsolefile NewConsole.psc1

Leverantörerna och cmdletarna i snapin-modulen är nu tillgängliga för användning i sessionen.

TA BORT EN SNAPIN-MODUL

Om du vill ta bort en Windows PowerShell snapin-modul från den aktuella sessionen använder du cmdleten Remove-PSSnapin. Om du till exempel vill ta bort SQL Server snapin-modulen från den aktuella sessionen skriver du:

Remove-PSSnapin sql

Den här cmdleten tar bort snapin-modulen från sessionen. Snapin-modulen läses fortfarande in, men de providers och cmdletar som stöds är inte längre tillgängliga.

INBYGGDA KOMMANDON

I Windows PowerShell 2.0 och i äldre värdprogram i Windows PowerShell 3.0 och senare paketeras de inbyggda kommandona som installeras med Windows PowerShell i snapin-moduler som läggs till automatiskt i varje Windows PowerShell session.

Från och med Windows PowerShell 3.0, i senare värdprogram – de som startar sessioner med hjälp av metoden InitialSessionState.CreateDefault2 – paketeras de inbyggda kommandona i moduler. Undantaget är Microsoft.PowerShell.Core, som alltid visas som en snapin-modul. Snapin-modulen Core ingår som standard i varje session. De inbyggda modulerna läses in automatiskt vid första användningen.

Obs! Fjärrsessioner, inklusive sessioner som startas med hjälp av cmdleten New-PSSession, är äldre sessioner där de inbyggda kommandona paketeras i snapin-moduler.

Följande snapin-moduler (eller moduler) installeras med Windows PowerShell.

Microsoft.PowerShell.Core – innehåller leverantörer och cmdletar som används för att hantera de grundläggande funktionerna i Windows PowerShell. Den innehåller filsystems-, register-, alias-, miljö-, funktions- och variabelprovidrar och grundläggande cmdletar som Get-Help, Get-Command och Get-History.
Microsoft.PowerShell.Host – innehåller cmdletar som används av Windows PowerShell-värden, till exempel Start-Transcript och Stop-Transcript.
Microsoft.PowerShell.Management – innehåller cmdletar som Get-Service och Get-ChildItem som används för att hantera Windows-baserade funktioner.
Microsoft.PowerShell.Security – innehåller certifikatprovidern och cmdletar som används för att hantera Windows PowerShell säkerhet, till exempel Get-Acl, Get-AuthenticodeSignature och ConvertTo-SecureString.
Microsoft.PowerShell.Utility – innehåller cmdletar som används för att manipulera objekt och data, till exempel Get-Member, Write-Host och Format-List.
Microsoft.WSMan.Management – innehåller WSMan-providern och cmdletar som hanterar Windows Remote Management-tjänsten, till exempel Connect-WSMan och Enable-WSManCredSSP.

LOGGA SNAPIN-HÄNDELSER

Från och med Windows PowerShell 3.0 kan du registrera körningshändelser för cmdletar i Windows PowerShell moduler och snapin-moduler genom att ange egenskapen LogPipelineExecutionDetails för moduler och snapin-moduler till TRUE. Mer information finns i about_EventLogs.