Get-IseSnippet

Referens

Modul:: ISE

Hämtar kodfragment som användaren skapade.

Syntax

Get-IseSnippet []

Description

Cmdleten Get-IseSnippet hämtar PS1XML-filerna som innehåller återanvändbara textfragment som användaren skapade. Det fungerar bara i Windows PowerShell ISE (Integrated Scripting Environment).

När du använder cmdleten New-IseSnippet för att skapa ett kodfragment New-IseSnippet skapar du en <SnippetTitle>.Snippets.ps1xml fil i $home\Documents\WindowsPowerShell\Snippets katalogen. 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 .

Denna cmdlet introducerades i Windows PowerShell 3.0.

Exempel

Exempel 1: Hämta alla användardefinierade kodfragment

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

Get-IseSnippet

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

I det här exemplet kopieras alla användarskapade kodfragment från en grupp fjärrdatorer till en delad kodfragmentkatalog.

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

Invoke-Command körs Get-IseSnippet på datorerna Servers.txt i filen. En pipelineoperator (|) skickar kodfragmentfilerna till cmdleten Copy-Item som kopierar dem till den katalog som anges av målparametern.

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

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

#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

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

I det här exemplet visas rubriken och beskrivningen för alla kodfragment i sessionen, inklusive inbyggda kodfragment, användardefinierade kodfragment och importerade kodfragment.

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

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.

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

Cmdleten Format-Table visar 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. Därför kan Windows PowerShell inte lägga till dem i en session där körningsprincipen är AllSigned eller Restricted. I en begränsad session 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 cmdleten Get-IseSnippet returnerar ändrar du körningsprincipen och startar sedan om Windows PowerShell ISE.

Mer information om Windows PowerShell körningsprinciper finns i about_Execution_Policies.