Import-IseSnippet

  • Referencia
Modul:
ISE

I Standard kiadás kódrészletek importálása az aktuális munkamenetbe

Syntax

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

Description

A Import-IseSnippet parancsmag újrahasználható szövegrészleteket importál egy modulból vagy könyvtárból az aktuális munkamenetbe. A kódrészletek azonnal elérhetők a Windows PowerShell I Standard kiadás-ban való használatra. Ez a parancsmag csak a Windows PowerShell integrált szkriptelési környezetében (I Standard kiadás) működik.

Az importált kódrészletek megtekintéséhez és használatához a Windows PowerShell I Standard kiadás Szerkesztés menüjében kattintson a Kódrészletek indítása parancsra, vagy nyomja le a Ctrl J billentyűkombinációt+.

Az importált kódrészletek csak az aktuális munkamenetben érhetők el. Ha importálni szeretné a kódrészleteket az összes Windows PowerShell I Standard kiadás-munkamenetbe, adjon hozzá egy Import-IseSnippet parancsot a Windows PowerShell-profiljához, vagy másolja a kódrészletfájlokat a helyi kódrészletek könyvtárába$HOME\Documents\WindowsPowershell\Snippets.

A kódrészletek importálásához megfelelően kell formázni őket a Windows PowerShell I kódrészlet XML-kódrészletében Standard kiadás kódrészletekben, és snippet.ps1xml fájlokba kell menteni őket. A jogosult kódrészletek létrehozásához használja a New-IseSnippet parancsmagot. New-IseSnippet létrehoz egy <SnippetTitle>.Snippets.ps1xml fájlt a $HOME\Documents\WindowsPowerShell\Snippets könyvtárban. A kódrészleteket áthelyezheti vagy átmásolhatja egy Windows PowerShell-modul Kódrészletek könyvtárába vagy bármely más könyvtárba.

A Get-IseSnippet helyi kódrészletek könyvtárában felhasználó által létrehozott kódrészleteket lekérő parancsmag nem kap importált kódrészleteket.

Ezt a parancsmagot a Windows PowerShell 3.0-ban vezettük be.

Példák

1. példa: Kódrészletek importálása könyvtárból

Ez a példa importálja a kódrészleteket a \\Server01\Public\Snippets könyvtárból az aktuális munkamenetbe. A Recurse paramétert használja a Kódrészletek könyvtár összes alkönyvtárának kódrészleteinek lekéréséhez.

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

2. példa: Kódrészletek importálása modulból

Ez a példa importálja a kódrészleteket a KódrészletModule modulból. A parancs a ListAvailable paraméter használatával importálja a kódrészleteket akkor is, ha a kódrészletModule modul nem importálódik a felhasználó munkamenetébe a parancs futtatásakor.

Import-IseSnippet -Module SnippetModule -ListAvailable

3. példa: Kódrészletek keresése modulokban

Ez a példa a PSModulePath környezeti változó összes telepített moduljában lekéri a kódrészleteket.

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

4. példa: Az összes modulrészlet importálása

Ez a példa az összes telepített modulból importálja az összes kódrészletet az aktuális munkamenetbe. Általában nem kell ilyen parancsot futtatnia, mert a kódrészletekkel rendelkező modulok a Import-IseSnippet parancsmaggal importálják őket a modul importálásakor.

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

5. példa: Az összes modulrészlet másolása

Ez a példa az összes telepített modul kódrészletfájljait az Snippets aktuális felhasználó könyvtárába másolja. Az importált kódrészletekkel ellentétben, amelyek csak az aktuális munkamenetet érintik, a másolt kódrészletek minden Windows PowerShell I Standard kiadás munkamenetben elérhetők.

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

Paraméterek

-ListAvailable

Azt jelzi, hogy ez a parancsmag kódrészleteket kap a számítógépre telepített modulokból, még akkor is, ha a modulok nem importálódnak az aktuális munkamenetbe. Ha ez a paraméter nincs megadva, és a Modul paraméter által megadott modul nem lesz importálva az aktuális munkamenetbe, a kódrészletek modulból való lekérésének kísérlete meghiúsul.

Ez a paraméter csak akkor érvényes, ha a modulparamétert használja a parancs.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Module

Kódrészleteket importál a megadott modulból az aktuális munkamenetbe. A helyettesítő karakterek nem támogatottak.

Ez a paraméter a modul elérési útjának Kódrészletek alkönyvtárában lévő fájlokból Snippet.ps1xml importál kódrészleteket, például $HOME\Documents\WindowsPowerShell\Modules\<ModuleName>\Snippets.

Ezt a paramétert úgy tervezték, hogy a modul szerzői egy indítási szkriptben használják, például egy moduljegyzék ScriptsToProcess kulcsában megadott szkriptet. A modulban lévő kódrészletek nem lesznek automatikusan importálva a modullal, de egy Import-IseSnippet paranccsal importálhatja őket.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Path

Megadja annak a kódrészlet-könyvtárnak az elérési útját, amelyben ez a parancsmag importálja a kódrészleteket.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:True

-Recurse

Azt jelzi, hogy ez a parancsmag a Path paraméter értékének minden alkönyvtárából importál kódrészleteket.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Bevitelek

None

Ehhez a parancsmaghoz nem lehet objektumokat csövezni.

Kimenetek

None

Ez a parancsmag nem ad vissza kimenetet.

Jegyzetek

  • Nem használhatja a Get-IseSnippet parancsmagot az importált kódrészletek lekéréséhez. Get-IseSnippet csak a könyvtárban lévő $HOME\Documents\WindowsPowerShell\Snippets kódrészleteket kapja meg.

  • Import-IseSnippetA Microsoft.PowerShell.Host.I Standard kiadás statikus betöltése metódust használja. I Standard kiadás SnippetCollection objektumok. A Kódrészletek betöltése metódust a Windows PowerShell I Standard kiadás objektummodellben is használhatja:$psISE.CurrentPowerShellTab.Snippets.Load()

  • A New-IseSnippet parancsmag az új, felhasználó által létrehozott kódrészleteket nem aláírt .ps1xml fájlokban tárolja. Ezért a Windows PowerShell nem tudja betölteni őket olyan munkamenetbe, amelyben a végrehajtási szabályzat AllSigned vagy Restricted. Korlátozott vagy AllSigned munkamenetekben létrehozhat, lekérhet és importálhat nem hozzárendelt, felhasználó által létrehozott kódrészleteket, de a munkamenetben nem használhatja őket.

    A parancsmag által visszaadott aláíratlan, felhasználó által létrehozott kódrészletek Import-IseSnippet használatához módosítsa a végrehajtási szabályzatot, majd indítsa újra a Windows PowerShell I Standard kiadás.

    További információ a Windows PowerShell végrehajtási szabályzatairól: about_Execution_Policies.