Import-IseSnippet

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

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

El cmdlet import-IseSnippet importa fragmentos de texto reutilizables de un módulo o un directorio en la sesión actual. Los fragmentos de código están disponibles inmediatamente para su uso en Windows PowerShell ISE. Este cmdlet solo funciona en el entorno de scripting integrado (ISE) de Windows PowerShell.

Para ver y usar los fragmentos de código importados, en el menú Windows PowerShell ISEEdit, haga clic en Iniciar fragmentos de código o presione Ctrl + J.

Los fragmentos de código importados solo están disponibles en la sesión actual. Para importar los fragmentos de código en todas las sesiones de Windows PowerShell ISE, agregue una comando Import-IseSnippet al perfil de Windows PowerShell o copie los archivos de fragmento de código en el directorio de fragmentos de código local ($home\Documents\WindowsPowershell\Snippets).

Para importar fragmentos de código, deben tener el formato correcto en el XML del fragmento de código para los fragmentos de código ISE de Windows PowerShell y guardarlos en archivos Snippet.ps1xml. Para crear fragmentos de código aptos, use el cmdlet New-IseSnippet. New-IseSnippet crea un<>SnippetTitle . Archivo Snippets.ps1xml en el directorio $home\Documents\WindowsPowerShell\Snippets. Puede mover o copiar los fragmentos de código al directorio Fragmentos de código de un módulo de Windows PowerShell o a cualquier otro directorio.

El cmdlet Get-IseSnippet, que obtiene fragmentos de código creados por el usuario en el directorio de fragmentos de código locales, no obtiene fragmentos de código importados.

Este cmdlet se introdujo en Windows PowerShell 3.0.

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

Este comando importa los fragmentos de código del directorio \\Server01\Public\Snippets en la sesión actual. Usa el parámetro Recurse para obtener fragmentos de código de todos los subdirectorios del directorio Snippets.

Import-IseSnippet -Module SnippetModule -ListAvailable

Este comando importa los fragmentos de código del módulo SnippetModule. El comando usa el parámetro ListAvailable para importar los fragmentos de código incluso si el módulo SnippetModule no se importa en la sesión del usuario cuando se ejecuta el comando.

($env:PSModulePath).split(";") | ForEach-Object {dir $_\*\Snippets\*.Snippets.ps1xml -ErrorAction SilentlyContinue} | ForEach-Object {$_.fullname}

Este comando obtiene fragmentos de código de todos los módulos instalados en la variable de entorno PSModulePath.

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

Este comando importa todos los fragmentos de código de todos los módulos instalados en la sesión actual. Normalmente, no es necesario ejecutar un comando como este porque los módulos que tienen fragmentos de código usarán el cmdlet import-IseSnippet para importarlos cuando se importe el módulo.

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

Este comando copia los archivos de fragmento de código de todos los módulos instalados en el directorio Fragmentos de código del usuario actual. A diferencia de los fragmentos de código importados, que afectan solo a la sesión actual, los fragmentos de código copiados están disponibles en cada sesión de Windows PowerShell ISE.

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

Este cmdlet no toma la entrada de la canalización.

Este cmdlet no genera resultados.

• No puede usar el cmdlet Get-IseSnippet para obtener fragmentos de código importados. get-IseSnippet obtiene solo fragmentos de código en el directorio $home\Documents\WindowsPowerShell\Snippets.

• import-IseSnippet usa el método estático Load de objetos Microsoft.PowerShell.Host.ISE.ISESnippetCollection. También puede usar el método Load de fragmentos de código en el modelo de objetos de Windows PowerShell ISE: $psISE.CurrentPowerShellTab.Snippets.Load()

• El cmdlet New-IseSnippet almacena nuevos fragmentos de código creados por el usuario en archivos .ps1xml sin firmar. Por lo tanto, Windows PowerShell no puede cargarlos en una sesión en la que la directiva de ejecución se AllSigned o Restringido. En una sesión de Restricted o AllSigned, puede crear, obtener e importar fragmentos de código sin firmar creados por el usuario, pero no puede usarlos en la sesión.

  Para usar fragmentos de código creados por el usuario sin firmar que el cmdlet import-IseSnippet devuelve, cambie la directiva de ejecución y, a continuación, reinicie Windows PowerShell ISE.

  Para obtener más información sobre las directivas de ejecución de Windows PowerShell, consulte about_Execution_Policies.