New-IseSnippet

New-IseSnippet
    [-Title] <String>
    [-Description] <String>
    [-Text] <String>
    [-Author <String>]
    [-CaretOffset <Int32>]
    [-Force]
    [<CommonParameters>]

De cmdlet New-ISESnippet maakt een herbruikbaar tekstfragment voor Windows PowerShell ISE. U kunt fragmenten gebruiken om tekst toe te voegen aan het deelvenster Script of het opdrachtvenster in Windows PowerShell ISE. Deze cmdlet is alleen beschikbaar in Windows PowerShell ISE.

Vanaf Windows PowerShell 3.0 bevat Windows PowerShell ISE een verzameling ingebouwde fragmenten. Met de New-ISESnippet-cmdlet kunt u uw eigen fragmenten maken om toe te voegen aan de ingebouwde verzameling. U kunt fragmentbestanden bekijken, wijzigen, toevoegen, verwijderen en delen en opnemen in Windows PowerShell-modules. Als u fragmenten in Windows PowerShell ISE wilt zien, selecteert u in het menu BewerkenFragmenten starten of drukt u op Ctrl+J-.

De New-ISESnippet cmdlet maakt een <Title>.Snippets.ps1xml bestand in de $HOME\Documents\WindowsPowerShell\Snippets map met de titel die u opgeeft. Als u een fragmentbestand wilt opnemen in een module die u ontwerpt, voegt u het fragmentbestand toe aan een submap fragmenten van uw modulemap.

U kunt geen door de gebruiker gemaakte fragmenten gebruiken in een sessie waarin het uitvoeringsbeleid is Beperkt of AllSigned.

Deze cmdlet is geïntroduceerd in Windows PowerShell 3.0.

New-IseSnippet -Title Comment-BasedHelp -Description "A template for comment-based help." -Text "<#
    .SYNOPSIS

    .DESCRIPTION
    .PARAMETER  <Parameter-Name>
    .INPUTS
    .OUTPUTS
    .EXAMPLE
    .LINK
#>"

Met deze opdracht maakt u een Comment-BasedHelp fragment voor Windows PowerShell ISE. Er wordt een bestand gemaakt met de naam Comment-BasedHelp.snippets.ps1xml in de map Fragmenten van de gebruiker $HOME\Documents\WindowsPowerShell\Snippets.

$M = @'
param
(
  [Parameter(Mandatory=$true)]
  [string[]]
  $<ParameterName>
)
'@

$snippet = @{
    Text = $M
    Title = 'Mandatory'
    Description = 'Adds a mandatory function parameter.'
    Author = 'Patti Fuller, Fabrikam Corp.'
    Force = $true
}
New-ISESnippet @snippet

In dit voorbeeld wordt een fragment gemaakt met de naam Verplichte voor Windows PowerShell ISE. Met de eerste opdracht wordt de codefragmenttekst opgeslagen in de variabele $M. De tweede opdracht maakt gebruik van de New-ISESnippet cmdlet om het fragment te maken. De opdracht gebruikt de parameter Forceren om een eerder fragment met dezelfde naam te overschrijven.

$path = "$HOME\Documents\WindowsPowerShell\Snippets\Mandatory.Snippets.ps1xml"
$destination = "\\Server\Share"
Copy-Item -Path $path -Destination $destination

Met deze opdracht wordt de Copy-Item-cmdlet gebruikt om het verplicht fragment te kopiëren uit de map waarin New-ISESnippet deze op de server\Share-bestandsshare plaatst.

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

U kunt geen objecten doorsluisen naar deze cmdlet.

Deze cmdlet retourneert geen uitvoer.

New-IseSnippet slaat nieuwe door de gebruiker gemaakte fragmenten op in niet-ondertekende .ps1xml bestanden. Als zodanig kan Windows PowerShell deze niet toevoegen aan een sessie waarin het uitvoeringsbeleid is AllSigned of Restricted. In een beperkte of sessie AllSigned kunt u niet-ondertekende door de gebruiker gemaakte fragmenten maken, ophalen en importeren, maar u kunt deze niet gebruiken in de sessie.

Als u de cmdlet New-IseSnippet in een beperkte of allsigned sessie gebruikt, wordt het fragment gemaakt, maar wordt er een foutbericht weergegeven wanneer Windows PowerShell probeert het zojuist gemaakte fragment toe te voegen aan de sessie. Als u het nieuwe fragment (en andere niet-ondertekende door de gebruiker gemaakte fragmenten) wilt gebruiken, wijzigt u het uitvoeringsbeleid en start u Windows PowerShell ISE opnieuw.

Zie about_Execution_Policiesvoor meer informatie over het windows PowerShell-uitvoeringsbeleid.

• Als u een fragment wilt wijzigen, bewerkt u het fragmentbestand. U kunt fragmentbestanden bewerken in het deelvenster Script van Windows PowerShell ISE.
• Als u een fragment wilt verwijderen dat u hebt toegevoegd, verwijdert u het fragmentbestand.
• U kunt een ingebouwd fragment niet verwijderen, maar u kunt alle ingebouwde fragmenten verbergen met behulp van de opdracht $psISE.Options.ShowDefaultSnippets=$false.
• U kunt een fragment maken met dezelfde naam als een ingebouwd fragment. Beide fragmenten worden weergegeven in het menu fragment in Windows PowerShell ISE.