Get-IseSnippet

  • Referencia
Modul:
ISE

Lekéri a felhasználó által létrehozott kódrészleteket.

Syntax

Get-IseSnippet []

Description

A Get-IseSnippet parancsmag lekéri a felhasználó által létrehozott újrafelhasználható szövegrészleteket tartalmazó PS1XML-fájlokat. Csak a Windows PowerShell integrált szkriptelési környezetében (I Standard kiadás) működik.

Ha a New-IseSnippet parancsmaggal hoz létre egy kódrészletet, New-IseSnippet hozzon létre egy <SnippetTitle>.Snippets.ps1xml fájlt a $HOME\Documents\WindowsPowerShell\Snippets könyvtárban. Get-IseSnippet lekéri a kódrészletfájlokat a Kódrészletek könyvtárban.

Ez a parancsmag nem kap beépített kódrészleteket vagy kódrészleteket, amelyeket a parancsmagon keresztül importál a Import-IseSnippet modulokból.

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

Példák

1. példa: Az összes felhasználó által definiált kódrészlet lekérése

Ez a példa lekéri a kódrészletek könyvtárában található összes felhasználó által definiált kódrészletet.

Get-IseSnippet

2. példa: Az összes felhasználó által definiált kódrészlet másolása távoli számítógépekről egy megosztott könyvtárba

Ez a példa az összes felhasználó által létrehozott kódrészletet átmásolja egy távoli számítógépcsoportból egy megosztott kódrészlet-könyvtárba.

Invoke-Command -Computer (Get-Content Servers.txt) {Get-IseSnippet | Copy-Item -Destination \\Server01\Share01\Snippets}

Invoke-Command fut Get-IseSnippet a fájlban lévő Servers.txt számítógépeken. A folyamatkezelő (|) elküldi a kódrészletfájlokat a Copy-Item parancsmagnak, amely a Cél paraméter által megadott könyvtárba másolja őket.

3. példa: Az egyes kódrészletek címének és szövegének megjelenítése egy helyi számítógépen

Ez a példa a Get-IseSnippetSelect-Xml parancsmagokkal jeleníti meg az egyes kódrészletek címét és szövegét a helyi számítógépen.

#Parse-Snippet Function
function Parse-Snippet {
  $SnippetFiles = Get-IseSnippet
  $SnippetNamespace = @{x="http://schemas.microsoft.com/PowerShell/Snippets"}
  foreach ($SnippetFile in $SnippetFiles) {
     Write-Host ""
     $Title = Select-Xml -Path $SnippetFile.FullName -Namespace $SnippetNamespace -XPath "//x:Title" |
       ForEach-Object {$_.Node.InnerXML}
     $Text = Select-Xml -Path $SnippetFile.FullName -Namespace $SnippetNamespace -XPath "//x:Script" |
       ForEach-Object {$_.Node.InnerText}
     Write-Host "Title: $Title"
     Write-Host "Text: $Text"
   }
}

Title: Mandatory
Text:
Param
(
  [parameter(Mandatory=True)]
  [String[]]
  $<ParameterName>
)

Title: Copyright
Text:  (c) Fabrikam, Inc. 2012

4. példa: A munkamenet összes kódrészletének címe és leírása

Ez a példa a munkamenet összes kódrészletének címét és leírását jeleníti meg, beleértve a beépített kódrészleteket, a felhasználó által definiált kódrészleteket és az importált kódrészleteket.

$PSISE.CurrentPowerShellTab.Snippets | Format-Table DisplayTitle, Description

A $PSISE változó a Windows PowerShell I Standard kiadás gazdaprogramot jelöli. A változó CurrentPowerShellTab tulajdonsága az $PSISE aktuális munkamenetet jelöli. A Kódrészletek tulajdonság az aktuális munkamenet kódrészleteit jelöli.

A $PSISE.CurrentPowerShellTab.Snippets parancs egy Microsoft.PowerShell.Host.I Standard kiadás értéket ad vissza. I Standard kiadás Snippet objektum, amely egy kódrészletet jelöl, ellentétben a Get-IseSnippet parancsmaggal. Get-IseSnippet Egy kódrészletfájlt képviselő fájlobjektumot (System.Io.FileInfo) ad vissza.

A Format-Table parancsmag megjeleníti a tábla kódrészleteinek DisplayTitle és Description tulajdonságait.

Bevitelek

None

Ehhez a parancsmaghoz nem lehet objektumokat csövezni.

Kimenetek

FileInfo

Ez a parancsmag egy fájlobjektumot ad vissza, amely a kódrészletfájlt jelöli.

Jegyzetek

  • 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 hozzáadni őket olyan munkamenethez, amelyben a végrehajtási szabályzat AllSigned vagy Korlátozott. 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 Get-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.