Import-IseSnippet

Import-IseSnippet
    [-Path] <String>
    [-Recurse]
    [<CommonParameters>]

Import-IseSnippet
    -Module <String>
    [-Recurse]
    [-ListAvailable]
    [<CommonParameters>]

Cmdleten Import-IseSnippet importerar återanvändbar text "kodfragment" från en modul eller en katalog till den aktuella sessionen. Kodfragmenten är omedelbart tillgängliga för användning i Windows PowerShell ISE. Den här cmdleten fungerar endast i Windows PowerShell Integrated Scripting Environment (ISE).

Om du vill visa och använda de importerade kodfragmenten går du till Menyn Windows PowerShell ISE Redigera och klickar på Starta kodfragment eller trycker på Ctrl+J.

Importerade kodfragment är endast tillgängliga i den aktuella sessionen. Om du vill importera kodfragmenten till alla Windows PowerShell ISE-sessioner lägger du till ett Import-IseSnippet-kommando i Din Windows PowerShell-profil eller kopierar kodfragmentfilerna till din lokala kodfragmentkatalog $HOME\Documents\WindowsPowerShell\Snippets.

Om du vill importera kodfragment måste de vara korrekt formaterade i kodfragmentets XML för Windows PowerShell ISE-kodfragment och sparas i Snippet.ps1xml-filer. Om du vill skapa berättigade kodfragment använder du cmdleten New-IseSnippet. New-IseSnippet skapar en <SnippetTitle>.Snippets.ps1xml-fil i katalogen $HOME\Documents\WindowsPowerShell\Snippets. Du kan flytta eller kopiera kodfragmenten till katalogen Kodfragment i en Windows PowerShell-modul eller till någon annan katalog.

Cmdleten Get-IseSnippet, som hämtar användarskapade kodfragment i den lokala kodfragmentkatalogen, får inte importerade kodfragment.

Den här cmdleten introducerades i Windows PowerShell 3.0.

I det här exemplet importeras kodfragmenten från katalogen \\Server01\Public\Snippets till den aktuella sessionen. Den använder parametern Recurse för att hämta kodfragment från alla underkataloger i katalogen Kodfragment.

Import-IseSnippet -Path \\Server01\Public\Snippets -Recurse

I det här exemplet importeras kodfragmenten från modulen SnippetModule. Kommandot använder parametern ListAvailable för att importera kodfragmenten även om modulen SnippetModule inte importeras till användarens session när kommandot körs.

Import-IseSnippet -Module SnippetModule -ListAvailable

Det här exemplet hämtar kodfragment i alla installerade moduler i miljövariabeln PSModulePath.

($Env:PSModulePath).Split(";") |
  ForEach-Object {dir $_\*\Snippets\*.Snippets.ps1xml -ErrorAction SilentlyContinue} |
    ForEach-Object {$_.FullName}

Det här exemplet importerar alla kodfragment från alla installerade moduler till den aktuella sessionen. Vanligtvis behöver du inte köra ett kommando som det här eftersom moduler som har kodfragment använder Import-IseSnippet cmdlet för att importera dem åt dig när modulen importeras.

($Env:PSModulePath).Split(";") |
  ForEach-Object {dir $_\*\Snippets\*.Snippets.ps1xml -ErrorAction SilentlyContinue} |
    ForEach-Object {$psISE.CurrentPowerShellTab.Snippets.Load($_)}

I det här exemplet kopieras kodfragmentfilerna från alla installerade moduler till den aktuella användarens Snippets katalog. Till skillnad från importerade kodfragment, som endast påverkar den aktuella sessionen, är kopierade kodfragment tillgängliga i varje Windows PowerShell ISE-session.

($Env:PSModulePath).Split(";") |
  ForEach-Object {dir $_\*\Snippets\*.Snippets.ps1xml -ErrorAction SilentlyContinue} |
    Copy-Item -Destination $HOME\Documents\WindowsPowerShell\Snippets

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

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

Den här cmdleten returnerar inga utdata.

• Du kan inte använda cmdleten Get-IseSnippet för att hämta importerade kodfragment. Get-IseSnippet hämtar bara kodfragment i katalogen $HOME\Documents\WindowsPowerShell\Snippets.

• Import-IseSnippet använder den statiska metoden Load för Microsoft.PowerShell.Host.ISE.ISESnippetCollection objekt. Du kan också använda metoden Load för kodfragment i Windows PowerShell ISE-objektmodellen: $psISE.CurrentPowerShellTab.Snippets.Load()

• Cmdleten New-IseSnippet lagrar nya användarskapade kodfragment i osignerade .ps1xml filer. Därför kan Windows PowerShell inte läsa in dem i en session där körningsprincipen är AllSigned eller Restricted. I en Begränsad eller AllSigned session kan du skapa, hämta och importera osignerade användarskapade kodfragment, men du kan inte använda dem i sessionen.

  Om du vill använda osignerade användarskapade kodfragment som Import-IseSnippet cmdlet returnerar ändrar du körningsprincipen och startar sedan om Windows PowerShell ISE.

  Mer information om Körningsprinciper för Windows PowerShell finns i about_Execution_Policies.