Get-IseSnippet

  • Referensi
Modul:
ISE

Mendapatkan cuplikan yang dibuat pengguna.

Sintaks

Get-IseSnippet []

Deskripsi

Get-IseSnippet Cmdlet mendapatkan file PS1XML yang berisi cuplikan teks yang dapat digunakan kembali yang dibuat pengguna. Ini hanya berfungsi di Windows PowerShell Integrated Scripting Environment (ISE).

Saat Anda menggunakan New-IseSnippet cmdlet untuk membuat cuplikan, New-IseSnippet membuat <SnippetTitle>.Snippets.ps1xml file di $HOME\Documents\WindowsPowerShell\Snippets direktori. Get-IseSnippet mendapatkan file cuplikan di direktori Cuplikan.

Cmdlet ini tidak mendapatkan cuplikan atau cuplikan bawaan yang diimpor dari modul melalui Import-IseSnippet cmdlet.

Cmdlet ini diperkenalkan di Windows PowerShell 3.0.

Contoh

Contoh 1: Mendapatkan semua cuplikan yang ditentukan pengguna

Contoh ini mendapatkan semua cuplikan yang ditentukan pengguna di direktori Cuplikan.

Get-IseSnippet

Contoh 2: Salin semua cuplikan yang ditentukan pengguna dari komputer jarak jauh ke direktori bersama

Contoh ini menyalin semua cuplikan yang dibuat pengguna dari sekelompok komputer jarak jauh ke direktori Cuplikan bersama.

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

Invoke-CommandGet-IseSnippet berjalan pada komputer dalam Servers.txt file. Operator alur (|) mengirim file cuplikan ke Copy-Item cmdlet, yang menyalinnya ke direktori yang ditentukan oleh parameter Tujuan .

Contoh 3: Menampilkan judul dan teks setiap cuplikan di komputer lokal

Contoh ini menggunakan Get-IseSnippet cmdlet dan Select-Xml untuk menampilkan judul dan teks setiap cuplikan di komputer lokal.

#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

Contoh 4: Menampilkan judul dan deskripsi semua cuplikan dalam sesi

Contoh ini menampilkan judul dan deskripsi semua cuplikan dalam sesi, termasuk cuplikan bawaan, cuplikan yang ditentukan pengguna, dan cuplikan yang diimpor.

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

Variabel $PSISE mewakili program host ISE Windows PowerShell. Properti CurrentPowerShellTab dari $PSISE variabel mewakili sesi saat ini. Properti Cuplikan mewakili cuplikan dalam sesi saat ini.

Perintah $PSISE.CurrentPowerShellTab.Snippets mengembalikan objek Microsoft.PowerShell.Host.ISE.ISESnippet yang mewakili cuplikan, tidak seperti Get-IseSnippet cmdlet. Get-IseSnippet mengembalikan objek file (System.Io.FileInfo) yang mewakili file cuplikan.

Format-Table Cmdlet menampilkan properti DisplayTitle dan Description dari cuplikan dalam tabel.

Input

None

Anda tidak dapat menyalurkan objek ke cmdlet ini.

Output

FileInfo

Cmdlet ini mengembalikan objek file yang mewakili file cuplikan.

Catatan

  • New-IseSnippet Cmdlet menyimpan cuplikan baru yang dibuat pengguna dalam file .ps1xml yang tidak ditandatangani. Dengan demikian, Windows PowerShell tidak dapat menambahkannya ke sesi di mana kebijakan eksekusi AllSigned atau Restricted. Dalam sesi Terbatas atau AllSigned, Anda dapat membuat, mendapatkan, dan mengimpor cuplikan yang dibuat pengguna yang tidak ditandatangani, tetapi Anda tidak dapat menggunakannya dalam sesi.

    Untuk menggunakan cuplikan yang dibuat pengguna yang tidak ditandatangani yang Get-IseSnippet dikembalikan cmdlet, ubah kebijakan eksekusi, lalu mulai ulang WINDOWS PowerShell ISE.

    Untuk informasi selengkapnya tentang kebijakan eksekusi Windows PowerShell, lihat about_Execution_Policies.