about_PSSnapins
Kort beskrivning
Beskriver Snapin-moduler för Windows PowerShell 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 kan innehålla Windows PowerShell-leverantörer och 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 leverantörer 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 sparade konfigurationen i framtida sessioner.
Från och med Windows PowerShell 3.0 paketeras de cmdletar som levereras med PowerShell i moduler. Undantaget är Microsoft.PowerShell.Core, som är den enda återstående snapin-modulen. Snapin-modulen Microsoft.PowerShell.Core läses in i varje session som standard. De återstående modulerna läses in automatiskt vid första användningen. Mer information finns i about_Modules.
Hitta en snapin-modul
Om du vill hämta en lista över Windows PowerShell-snapin-modulerna 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 alla registrerade snapin-moduler i systemet eller för att kontrollera att en snapin-modul har registrerats skriver du:
Get-PSSnapin -registered
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.
Lägga till en snapin-modul 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-moduler
Om du vill använda en snapin-modul i framtida Windows PowerShell-sessioner lägger du till Add-PsSnapin kommandot i din Windows PowerShell-profil. Du kan också exportera snapin-namnen till en konsolfil.
Om du lägger till kommandot i Add-PSSnapin din profil är det tillgängligt i alla framtida Windows PowerShell-sessioner. Om du exporterar namnen på snapin-modulerna i sessionen kan du endast använda exportfilen när du behöver snapin-modulerna.
Om du vill lägga till kommandot i Add-PsSnapin 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 NewConsole.psc1 till filen i den aktuella katalogen skriver du:
Export-Console NewConsole
Mer information finns i Export-Console.
Öppna Windows PowerShell med hjälp av 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 NewConsole.psc1 konsolfilen:
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 är fortfarande inläst, men de leverantörer och cmdletar som stöds är inte längre tillgängliga.
Logga snapin-in-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.
