Import-IseSnippet

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

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

Das cmdlet Import-IseSnippet importiert wiederverwendbare Textausschnitte aus einem Modul oder einem Verzeichnis in die aktuelle Sitzung. Die Codeausschnitte stehen sofort zur Verwendung in Windows PowerShell ISE zur Verfügung. Dieses Cmdlet funktioniert nur in windows PowerShell Integrated Scripting Environment (ISE).

Um die importierten Codeausschnitte anzuzeigen und zu verwenden, klicken Sie im Menü "Windows PowerShell ISE Bearbeiten" auf Codeausschnitte oder drücken Sie STRG+J.

Importierte Codeausschnitte sind nur in der aktuellen Sitzung verfügbar. Um die Codeausschnitte in alle Windows PowerShell ISE-Sitzungen zu importieren, fügen Sie Ihrem Windows PowerShell-Profil einen Import-IseSnippet Befehl hinzu, oder kopieren Sie die Codeausschnittdateien in das lokale Codeausschnittverzeichnis $HOME\Documents\WindowsPowerShell\Snippets.

Zum Importieren von Codeausschnitten müssen sie im Codeausschnitt-XML für Windows PowerShell ISE-Codeausschnitte ordnungsgemäß formatiert und in Codeausschnitten.ps1xml-Dateien gespeichert werden. Verwenden Sie zum Erstellen berechtigter Codeausschnitte das Cmdlet New-IseSnippet. New-IseSnippet erstellt eine <SnippetTitle>.Snippets.ps1xml Datei im $HOME\Documents\WindowsPowerShell\Snippets Verzeichnis. Sie können die Codeausschnitte in das Codeausschnittverzeichnis eines Windows PowerShell-Moduls oder in ein anderes Verzeichnis verschieben oder kopieren.

Das Cmdlet Get-IseSnippet, das vom Benutzer erstellte Codeausschnitte im lokalen Codeausschnittverzeichnis abruft, ruft keine importierten Codeausschnitte ab.

Dieses Cmdlet wurde in Windows PowerShell 3.0 eingeführt.

In diesem Beispiel werden die Codeausschnitte aus dem verzeichnis \\Server01\Public\Snippets in die aktuelle Sitzung importiert. Es verwendet den Recurse Parameter, um Codeausschnitte aus allen Unterverzeichnissen des Codeausschnittverzeichnisses abzurufen.

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

In diesem Beispiel werden die Codeausschnitte aus dem SnippetModule Modul importiert. Der Befehl verwendet den parameter ListAvailable, um die Codeausschnitte zu importieren, auch wenn das SnippetModule Modul nicht in die Sitzung des Benutzers importiert wird, wenn der Befehl ausgeführt wird.

Import-IseSnippet -Module SnippetModule -ListAvailable

In diesem Beispiel werden Codeausschnitte in allen installierten Modulen in der PSModulePath Umgebungsvariablen angezeigt.

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

In diesem Beispiel werden alle Codeausschnitte aus allen installierten Modulen in die aktuelle Sitzung importiert. In der Regel müssen Sie keinen Befehl wie diesen ausführen, da Module mit Codeausschnitten das cmdlet Import-IseSnippet verwenden, um sie beim Importieren des Moduls für Sie zu importieren.

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

In diesem Beispiel werden die Codeausschnittdateien aus allen installierten Modulen in das verzeichnis Snippets des aktuellen Benutzers kopiert. Im Gegensatz zu importierten Codeausschnitten, die sich nur auf die aktuelle Sitzung auswirken, sind kopierte Codeausschnitte in jeder Windows PowerShell ISE-Sitzung verfügbar.

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

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Sie können keine Objekte an dieses Cmdlet weiterleiten.

Dieses Cmdlet gibt keine Ausgabe zurück.

• Sie können das Cmdlet Get-IseSnippet nicht verwenden, um importierte Codeausschnitte abzurufen. Get-IseSnippet ruft nur Codeausschnitte im verzeichnis $HOME\Documents\WindowsPowerShell\Snippets ab.

• Import-IseSnippet verwendet die Load statische Methode von Microsoft.PowerShell.Host.ISE.ISESnippetCollection-Objekte. Sie können auch die Load Methode von Codeausschnitten im Windows PowerShell ISE-Objektmodell verwenden: $psISE.CurrentPowerShellTab.Snippets.Load()

• Das Cmdlet New-IseSnippet speichert neue vom Benutzer erstellte Codeausschnitte in nicht signierten .ps1xml Dateien. Daher kann Windows PowerShell sie nicht in eine Sitzung laden, in der die Ausführungsrichtlinie AllSigned oder Restrictedist. In einer Restricted oder AllSigned-Sitzung können Sie nicht signierte, vom Benutzer erstellte Codeausschnitte erstellen, abrufen und importieren, aber nicht in der Sitzung verwenden.

  Wenn Sie nicht signierte vom Benutzer erstellte Codeausschnitte verwenden möchten, die vom cmdlet Import-IseSnippet zurückgegeben werden, ändern Sie die Ausführungsrichtlinie, und starten Sie dann Windows PowerShell ISE neu.

  Weitere Informationen zu Windows PowerShell-Ausführungsrichtlinien finden Sie unter about_Execution_Policies.