Get-IseSnippet

Modul:: ISE Module

Hämtar kodfragment som användaren skapade.

Syntax

Default (Standard)

Get-IseSnippet

Description

Cmdleten Get-ISESnippet hämtar PS1XML-filer som innehåller återanvändbara textfragment som användaren har skapat. Det fungerar endast i Windows PowerShell Integrated Scripting Environment (ISE).

När du använder cmdleten New-IseSnippet för att skapa ett kodfragment skapar New-IseSnippet ett <SnippetTitle->. Filen Snippets.ps1xml i katalogen $home\Documents\WindowsPowerShell\Snippets. Get-ISESnippet hämtar kodfragmentfilerna i katalogen Kodfragment.

Den här cmdleten hämtar inte inbyggda kodfragment eller kodfragment som importeras från moduler via cmdleten Import-IseSnippet.

Den här cmdleten introducerades i Windows PowerShell 3.0.

Exempel

Exempel 1: Hämta alla användardefinierade kodfragment

PS C:\> Get-ISESnippet

Det här kommandot hämtar alla användardefinierade kodfragment i katalogen Kodfragment.

Exempel 2: Kopiera alla användardefinierade kodfragment från fjärrdatorer till en delad katalog

PS C:\> Invoke-Command -Computer (Get-Content Servers.txt) {Get-ISESnippet | Copy-Item -Destination \\Server01\Share01\Snippets}

Det här kommandot kopierar alla användarskapade kodfragment från en grupp fjärrdatorer till en delad kodfragmentkatalog.

Kommandot använder cmdleten Invoke-Command för att köra kommandot Get-ISESnippet på datorerna i filen Servers.txt. En pipelineoperator (|) skickar kodfragmentfilerna till cmdleten Copy-Item, som kopierar dem till katalogen som anges av parametern Destination.

Exempel 3: Visa rubrik och text för varje kodfragment på en lokal dator

PS C:\> #Parse-Snippet Function

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

# Sample Output

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

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

I det här exemplet används cmdletarna Get-ISESnippet och Select-Xml för att visa rubriken och texten för varje kodfragment på den lokala datorn.

Exempel 4: Visa rubriken och beskrivningen av alla kodfragment i sessionen

PS C:\> $PSISE.CurrentPowerShellTab.Snippets | Format-Table DisplayTitle, Description

Det här kommandot visar rubriken och beskrivningen av alla kodfragment i sessionen, inklusive inbyggda kodfragment, användardefinierade kodfragment och importerade kodfragment.

Kommandot använder Windows PowerShell ISE-objektmodellen. Variabeln $PSISE representerar Windows PowerShell ISE-värdprogrammet. Egenskapen CurrentPowerShellTab för variabeln $PSISE representerar den aktuella sessionen. Egenskapen kodfragment representerar kodfragment i den aktuella sessionen.

Den $PSISE. CurrentPowerShellTab.Snippets kommandot returnerar ett Microsoft.PowerShell.Host.ISE.ISESnippet objekt som representerar ett kodfragment, till skillnad från cmdleten Get-IseSnippet , som returnerar ett filobjekt (System.Io.FileInfo) som representerar en kodfragmentfil.

Kommandot använder också cmdleten Format-Table för att visa egenskaperna DisplayTitle och Description för kodfragmenten i en tabell.

Utdata

FileInfo

Den här cmdleten returnerar ett filobjekt som representerar kodfragmentfilen.

Kommentarer

Cmdleten New-IseSnippet lagrar nya användarskapade kodfragment i osignerade .ps1xml-filer. Windows PowerShell kan därför inte lägga till dem i en session där körningsprincipen är AllSigned eller Restricted. I en Begränsad eller AllSigned session kan du skapa, hämta och importera osignerade användarskapade kodfragment, men du kan inte använda dem i sessionen.

Om du vill använda osignerade användarskapade kodfragment som Get-IseSnippet cmdlet returnerar ändrar du körningsprincipen och startar sedan om Windows PowerShell ISE.

Mer information om Körningsprinciper för Windows PowerShell finns i about_Execution_Policies.

Dela via