about_PSSnapins

  • Artikel

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.

Se även