Import-IseSnippet

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

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

Met de Import-IseSnippet cmdlet importeert u herbruikbare tekstfragmenten uit een module of map in de huidige sessie. De fragmenten zijn onmiddellijk beschikbaar voor gebruik in Windows PowerShell ISE. Deze cmdlet werkt alleen in Windows PowerShell Integrated Scripting Environment (ISE).

Als u de geïmporteerde fragmenten wilt weergeven en gebruiken, klikt u in het menu Windows PowerShell ISE Bewerken op Fragmenten starten of drukt u op Ctrl+J.

Geïmporteerde fragmenten zijn alleen beschikbaar in de huidige sessie. Als u de fragmenten wilt importeren in alle Windows PowerShell ISE-sessies, voegt u een Import-IseSnippet opdracht toe aan uw Windows PowerShell-profiel of kopieert u de fragmentbestanden naar de map met lokale fragmenten $HOME\Documents\WindowsPowerShell\Snippets.

Als u fragmenten wilt importeren, moeten ze correct zijn opgemaakt in de XML van het fragment voor Windows PowerShell ISE-fragmenten en worden opgeslagen in snippet.ps1xml-bestanden. Gebruik de cmdlet New-IseSnippet om in aanmerking komende fragmenten te maken. New-IseSnippet maakt een <SnippetTitle>.Snippets.ps1xml bestand in de map $HOME\Documents\WindowsPowerShell\Snippets. U kunt de fragmenten verplaatsen of kopiëren naar de map Fragmenten van een Windows PowerShell-module of naar een andere map.

De Get-IseSnippet-cmdlet, waarmee door de gebruiker gemaakte fragmenten worden opgeslagen in de map met lokale fragmenten, worden geen geïmporteerde fragmenten weergegeven.

Deze cmdlet is geïntroduceerd in Windows PowerShell 3.0.

In dit voorbeeld worden de fragmenten uit de \\Server01\Public\Snippets map geïmporteerd in de huidige sessie. Hierbij wordt de parameter Recurse gebruikt om fragmenten op te halen uit alle submappen van de map Fragmenten.

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

In dit voorbeeld worden de fragmenten geïmporteerd uit de module SnippetModule. De opdracht gebruikt de parameter ListAvailable om de fragmenten te importeren, zelfs als de SnippetModule module niet wordt geïmporteerd in de sessie van de gebruiker wanneer de opdracht wordt uitgevoerd.

Import-IseSnippet -Module SnippetModule -ListAvailable

In dit voorbeeld worden fragmenten opgehaald in alle geïnstalleerde modules in de PSModulePath omgevingsvariabele.

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

In dit voorbeeld worden alle fragmenten uit alle geïnstalleerde modules geïmporteerd in de huidige sessie. Normaal gesproken hoeft u geen opdracht als deze uit te voeren, omdat modules met fragmenten de Import-IseSnippet cmdlet gebruiken om ze voor u te importeren wanneer de module wordt geïmporteerd.

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

In dit voorbeeld worden de codefragmentbestanden van alle geïnstalleerde modules gekopieerd naar de Snippets map van de huidige gebruiker. In tegenstelling tot geïmporteerde fragmenten, die alleen van invloed zijn op de huidige sessie, zijn gekopieerde fragmenten beschikbaar in elke Windows PowerShell ISE-sessie.

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

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

U kunt geen objecten doorsluisen naar deze cmdlet.

Deze cmdlet retourneert geen uitvoer.

• U kunt de Get-IseSnippet-cmdlet niet gebruiken om geïmporteerde fragmenten op te halen. Get-IseSnippet krijgt alleen fragmenten in de map $HOME\Documents\WindowsPowerShell\Snippets.

• Import-IseSnippet maakt gebruik van de statische methode Load van Microsoft.PowerShell.Host.ISE.ISESnippetCollection-objecten. U kunt ook de methode Laden codefragmenten in het Windows PowerShell ISE-objectmodel gebruiken: $psISE.CurrentPowerShellTab.Snippets.Load()

• Met de cmdlet New-IseSnippet worden nieuwe door de gebruiker gemaakte fragmenten opgeslagen in niet-ondertekende .ps1xml bestanden. Als zodanig kan Windows PowerShell deze niet laden in een sessie waarin het uitvoeringsbeleid is AllSigned of Restricted. In een beperkte of sessie AllSigned kunt u niet-ondertekende door de gebruiker gemaakte fragmenten maken, ophalen en importeren, maar u kunt deze niet gebruiken in de sessie.

  Als u niet-ondertekende door de gebruiker gemaakte fragmenten wilt gebruiken die door de Import-IseSnippet cmdlet worden geretourneerd, wijzigt u het uitvoeringsbeleid en start u Windows PowerShell ISE opnieuw.

  Zie about_Execution_Policiesvoor meer informatie over het windows PowerShell-uitvoeringsbeleid.