Delen via

Set-Clipboard

  • Referentie
Module:
Microsoft.PowerShell.Management

Hiermee stelt u de inhoud van het klembord in.

Syntaxis

Set-Clipboard
   [-Value] <string[]>
   [-Append]
   [-PassThru]
   [-AsOSC52]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

De Set-Clipboard cmdlet stelt de inhoud van het Klembord in.

Notitie

Voor Linux is voor deze cmdlet vereist dat het xclip hulpprogramma zich in het pad bevindt. In macOS gebruikt deze cmdlet het pbcopy hulpprogramma.

Voorbeelden

Voorbeeld 1: Tekst naar het klembord kopiëren

Set-Clipboard -Value "This is a test string"

Voorbeeld 2: De inhoud van een bestand naar het klembord kopiëren

In dit voorbeeld wordt de inhoud van een bestand, een openbare ssh-sleutel, naar het klembord gelezen. Vervolgens kan de sleutel worden geplakt in een andere toepassing, zoals GitHub.

Get-Content C:\Users\user1\.ssh\id_ed25519.pub | Set-Clipboard

Voorbeeld 3: Tekst kopiëren naar het klembord van de lokale host via een externe SSH-sessie

Met de parameter AsOSC52 kunt u het klembord van de lokale computer instellen wanneer u via SSH verbinding maakt met een externe sessie.

Set-Clipboard -Value "This is a test string" -AsOSC52

Voorbeeld 4: De standaardwaarde van de parameter **AsOSC52** instellen

U kunt detecteren of u bent verbonden met een externe sessie via SSH door de waarde van de $Env:SSH_CLIENT of $Env:SSH_TTY omgevingsvariabelen te controleren. Als een van deze variabelen is ingesteld, bent u verbonden met een externe sessie via SSH. U kunt deze informatie gebruiken om de standaardwaarde van de AsOSC52-parameter in te stellen. Voeg een van de volgende regels toe aan uw PowerShell-profielscript.

$PSDefaultParameterValues['Set-Clipboard:AsOSC52'] = $Env:SSH_CLIENT
$PSDefaultParameterValues['Set-Clipboard:AsOSC52'] = $Env:SSH_TTY

Zie about_Parameters_Default_Values$PSDefaultParameterValues

Parameters

-Append

Geeft aan dat de cmdlet moet worden toegevoegd aan het klembord in plaats van deze te vervangen. De cmdlet wist standaard de huidige inhoud van het Klembord en stelt deze in op de nieuwe inhoud. Wanneer deze parameter is opgegeven, voegt de cmdlet de nieuwe inhoud toe na een nieuwe regel aan de huidige inhoud.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-AsOSC52

Wanneer u via SSH verbinding maakt met een externe sessie, Set-Clipboard stelt u het klembord van de externe computer in, niet de lokale host. Wanneer u deze parameter gebruikt, Set-Clipboard gebruikt u de ESCAPE-reeks OSC52 ANSI om het klembord van de lokale computer in te stellen.

Deze functie werkt alleen als uw terminaltoepassing ondersteuning biedt voor de ESCAPE-reeks OSC52 ANSI. De Windows Terminal ondersteunt deze functie.

Deze parameter is toegevoegd in PowerShell 7.4.

Type:SwitchParameter
Aliassen:ToLocalhost
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-PassThru

Hiermee wordt een object geretourneerd dat het item aangeeft waarmee u werkt. Deze cmdlet genereert standaard geen uitvoer.

Type:SwitchParameter
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Value

De tekenreekswaarden die aan het klembord moeten worden toegevoegd.

Type:String[]
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

String

U kunt een tekenreeks met de inhoud doorsluisen die u wilt instellen op het Klembord op deze cmdlet.

Uitvoerwaarden

None

Deze cmdlet retourneert geen uitvoer.

Notities

PowerShell bevat de volgende aliassen voor Set-Clipboard:

  • Alle platforms:
    • scb

Ondersteuning voor deze cmdlet in macOS is toegevoegd in de PowerShell 7.0.0-release.