This is the built-in help made by Microsoft for the command 'Import-IseSnippet', in PowerShell version 5 - as retrieved from
Windows version 'Microsoft Windows Server 2012 R2 Standard' PowerShell help files on 2016-06-23.
For PowerShell version 3 and up, where you have Update-Help, this command was run just before creating the web pages from the help files.
Imports ISE snippets into the current session
Import-IseSnippet [-Path] <String> [-Recurse] [<CommonParameters>]
Import-IseSnippet [-ListAvailable] [-Recurse] -Module <String> [<CommonParameters>]
The Import-IseSnippet cmdlet imports reusable text "snippets" from a module or a directory into the current session. The snippets are immediately available for use in
Windows PowerShell ISE. This cmdlet works only in Windows PowerShell Integrated Scripting Environment (ISE).
To view and use the imported snippets, from the Windows PowerShell ISEEdit menu, click Start Snippets or press Ctrl + J.
Imported snippets are available only in the current session. To import the snippets into all Windows PowerShell ISE sessions, add an Import-IseSnippet command to your
Windows PowerShell profile or copy the snippet files to your local snippets directory ($home\Documents\WindowsPowershell\Snippets).
To be imported, the snippets must be properly formatted in the snippet XML for Windows PowerShell ISE snippets and saved in Snippet.ps1xml files. To create eligible
snippets, use the New-IseSnippet cmdlet. New-IseSnippet creates a <SnippetTitle>.Snippets.ps1xml file in the $home\Documents\WindowsPowerShell\Snippets directory. You can
move or copy the snippets to the Snippets directory of a Windows PowerShell module, or to any other directory.
NOTE: The Get-IseSnippet cmdlet, which gets user-created snippets in the local snippets directory, does not get imported snippets.
This cmdlet is introduced in Windows PowerShell 3.0.
<
Online Version: http://go.microsoft.com/fwlink/p/?linkid=287356
Get-IseSnippet
New-IseSnippet
<
Example 1: Import snippets from a directory
PS C:\>Import-IseSnippet -Path \\Server01\Public\Snippets -Recurse
This command imports the snippets from the \\Server01\Public\Snippets directory into the current session. It uses the Recurse parameter to get snippets from all
subdirectories of the Snippets directory.
Example 2: Import snippets from a module
PS C:\>Import-IseSnippet -Module SnippetModule -ListAvailable
This command imports the snippets from the SnippetModule module. The command uses the ListAvailable parameter to import the snippets even if the SnippetModule module is not
imported into the user's session when the command runs.
Example 3: Find snippets in modules
PS C:\>($env:PSModulePath).split(";") | foreach {dir $_\*\Snippets\*.Snippets.ps1xml -ErrorAction SilentlyContinue} | foreach {$_.fullname}
This command gets snippets in all installed modules in the PSModulePath environment variable.
Example 4: Import all module snippets
PS C:\>($env:PSModulePath).split(";") | foreach {dir $_\*\Snippets\*.Snippets.ps1xml -ErrorAction SilentlyContinue} | foreach {$psise.CurrentPowerShellTab.Snippets.Load($_)}
This command imports all snippets from all installed modules into the current session. Typically, you don't need to run a command like this because modules that have
snippets will use the Import-IseSnippet cmdlet to import them for you when the module is imported.
Example 5: Copy all module snippets
PS C:\>($env:PSModulePath).split(";") | foreach {dir $_\*\Snippets\*.Snippets.ps1xml -ErrorAction SilentlyContinue} | Copy-Item -Destination
$home\Documents\WindowsPowerShell\Snippets
This command copies the snippet files from all installed modules into the Snippets directory of the current user. Unlike imported snippets, which affect only the current
session, copied snippets are available in every Windows PowerShell ISE session.